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About Query Manager Use (SC41—5212) 


DB2 UDB for iSeries Query Manager is a database access and manipulation system suitable for use with 
all IBM® iSeries servers. This guide tells you how to use Query Manager to: 

* Create, maintain, and run queries 

* Create, maintain, and use report forms that format query output 

* Create, maintain, and use database tables 


To make full use of the tools that Query Manager provides, use this guide together with the online help 
that is available through all Query Manager displays. 


Who should use the Query Manager Use book 


This book is written for any iSeries user who wants to create and run queries, produce reports, or 
manipulate data in a database. 


To use this guide effectively, you should be familiar with the features of your display station and with the 
basic tasks of entering information and making selections from lists. It is also helpful (but not essential) to 
be familiar with the DB2 UDB for iSeries SQL language, and to have an understanding of the basic 
concepts behind databases and report formatting. 


Conventions used in the Query Manager Use book 


This guide presents examples of Query Manager displays as they appear to users who have an ALL user 
access level and are using SQL naming conventions. 


For many of the Query Manager displays, the options and function keys that are shown differ depending 
on the user access level. For example, users with an ALL access can create, change, display, print, and 
run queries, while users with BASIC access can only display, print, and run queries. (The create and 
change options are not shown on the query displays for BAS/C access users.) The default user access 
level is ALL. Displays included in this guide show the options and function keys that an ALL user sees. 


Through your Query Manager profile, you can specify whether you want to use SQL or SYS (system) 
naming conventions. This guide uses SQL conventions in both the displays and the text, so that collection, 
table, column, and row are used rather than library, file, field, and record. 


How to use the Query Manager Use book 


The following table should help you to quickly find the information you need to perform a specific task. If 
you want to perform a task that is not listed in this table, turn to the Contents (at the beginning of this 
guide) or the Index (at the end of this guide) for a more complete listing of topics. 


Table 1. Using This Book 


When you want to: Turn to: 
Read about Query Manager Page Hl 
Start using Query Manager Page | 
Perform practice exercises Page fisd 
Create SQL queries Page 74 
Create prompted queries Page [34 
Convert a prompted query to SQL Page f10) 
Run queries Page 14d 
Maintain queries Page 5d 


© Copyright IBM Corp. 1998, 2002 ix 


Table 1. Using This Book (continued) 


When you want to: Turn to: 
Specify a sort sequence Page Lo4) 
Format query results (using report forms) Page 15] 
Maintain report forms Page Lia) 

Run procedures Page 59 
View a list of allowed SQL statements Page Bil 

Read about the implications of allowed statements Page 269 
Create Query Manager tables Page [1571 

Add data to tables Page ed 

Print or view table data Page biz4, hal 
Maintain tables Page Ls 
Read about your Query Manager profile Page bd 
Adjust the settings in your profile Page 

View profile settings you cannot change Page 4 

Read about Query Manager (QM) statements Page bad 
Enter QM statements or system commands Page 

Connect to remote databases Page ad 

Find other specific information in this guide Contents, Index 


Prerequisite and related information 


Use the iSeries Information Center as your starting point for looking up iSeries technical information. 


You can access the Information Center two ways: 
* From the following Web site: 
http://www. ibm.com/eserver/iseries/infocenter 
¢ From CD-ROMs that ship with your Operating System/400 order: 
iSeries Information Center, SK3T-4091-02. This package also includes the PDF versions of iSeries 


manuals, iSeries Information Center: Supplemental Manuals, SK3T-4092-01, which replaces the 
Softcopy Library CD-ROM. 


The iSeries Information Center contains advisors and important topics such as Java, TCP/IP, Web serving, 
secured networks, logical partitions, clustering, CL commands, and system application programming 
interfaces (APIs). It also includes links to related IBM Redbooks and Internet links to other IBM Web sites 
such as the Technical Studio and the IBM home page. 


With every new hardware order, you receive the iSeries Setup and Operations CD-ROM, SK3T-4098-01. 
This CD-ROM contains IBM @server iSeries Access for Windows and the EZ-Setup wizard. iSeries 
Access offers a powerful set of client and server capabilities for connecting PCs to iSeries servers. The 
EZ-Setup wizard automates many of the iSeries setup tasks. 


iSeries Navigator 


IBM iSeries Navigator is a powerful graphical interface for managing your iSeries servers. iSeries 
Navigator functionality includes system navigation, configuration, planning capabilities, and online help to 
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guide you through your tasks. iSeries Navigator makes operation and administration of the server easier 
and more productive and is the only user interface to the new, advanced features of the OS/400 operating 
system. It also includes Management Central for managing multiple servers from a central server. 


You can find more information on iSeries Navigator in the iSeries Information Center and at the following 
Web site: 


http://www. ibm.com/eserver/iseries/navigator/ 


How to send your comments 


Your feedback is important in helping to provide the most accurate and high-quality information. If you 
have any comments about this book or any other iSeries documentation, fill out the readers’ comment 
form at the back of this book. 


* If you prefer to send comments by mail, use the readers’ comment form with the address that is printed 
on the back. If you are mailing a readers’ comment form from a country other than the United States, 
you can give the form to the local IBM branch office or IBM representative for postage-paid mailing. 


* If you prefer to send comments by FAX, use either of the following numbers: 
— United States, Canada, and Puerto Rico: 1-800-937-3430 
— Other countries: 1-507-253-5192 
* If you prefer to send comments electronically, use one of these e-mail addresses: 
— Comments on books: 
RCHCLERK @us.ibm.com 
— Comments on the iSeries Information Center: 
RCHINFOC @us.ibm.com 


Be sure to include the following: 

¢ The name of the book or iSeries Information Center topic. 

¢ The publication number of a book. 

* The page number or topic of a book to which your comment applies. 
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Chapter 1. Introducing Query Manager 


This chapter begins with a description of Query Manager, explaining what it is, and how to use it to 
perform different tasks and functions. Following the description are definitions of some of the terms and 
concepts used with Query Manager that you might not be familiar with. The chapter ends with an 
explanation of how Query Manager relates to other iSeries products. 


What is Query Manager? 


DB2® UDB for iSeries Query Manager, part of the IBM DB2 Query Manager and SQL Development Kit for 
iSeries licensed program, is a collection of tools you can use to obtain information from DB2 Universal 
Database™ for iSeries (DB2 UDB for iSeries) databases. 


You use Query Manager to select, arrange, and analyze information stored in one or more database 
tables, to produce reports or new tables. You can create and run your own query definitions, or you can 
run existing queries that you did not create. You can format the way that retrieved query information is 
presented by creating a report form, and applying it when you run a query, or you can let Query Manager 
format the query information for you, using a simple default report form. 


Query Manager queries are created using the DB2 UDB for iSeries SQL language. If you have little or no 
experience using the DB2 UDB for iSeries SQL language, you can still create and change queries using 
Query Manager’s prompted query creation mode. A series of displays prompt you to enter all of the 
information that DB2 UDB for iSeries needs to create a query. 


Query Manager queries can obtain information from a single table or from as many as 32 tables. You can 
select all the table columns, or only a few of the columns, and organize them for the type of output 
chosen. You can have all table rows in the output, or you can select only a few to be included, using row 
selection tests. You can also use report breaks and arithmetic summary functions to include additional 
information in your report, and make it easier to read. 


You determine what data the query is to retrieve, the format of the report, and whether the output should 
be displayed, printed, or sent to another database table. 


When you send query output to a database table, you can create a new table. You can also create and 
maintain database tables using Query Manager’s prompt-guided tables option. 


Another way of creating tables is through Query Manager’s command window. Using the command 
window, you can enter Query Manager statements and system commands to perform tasks such as: 


¢ Creating and saving queries 

¢ Running queries 

* Connecting to other databases 

¢ Importing and exporting objects 

¢ Running procedures that were created outside Query Manager 


All of these features are described in detail in this book. 


DB2 UDB for iSeries Query Manager can gather information from any database table in the network if the 
database is known to the system. Database tables must be defined on the system using Operating 
System/400* (OS/400*) data description specifications (DDS), the OS/400® interactive data definition utility 
(IDDU), or DB2 UDB for iSeries. Query Manager uses DB2 UDB for iSeries Query Management to 
manage query objects (*QMQRY) and report form objects (*QMFORM). 
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General concepts in Query Manager 


The following concepts and terms are used throughout Query Manager, and are referred to in this guide. 
Read through these definitions to gain a better understanding of the way Query Manager works. 


Databases, tables, columns, and rows in Query Manager 


The DB2 UDB for iSeries is a relational database that stores information at the most basic level in table 
format. A database can be compared to a filing cabinet: 


¢ The cabinet can have any number of drawers (libraries or collections). 

* Each drawer contains folders (tables). 

¢ Each folder contains pieces of paper (rows). 

* All pieces of paper in a given folder are identical “fill-in-the-blanks” forms. 


When you start Que Manager ou are connected to the database specified in your Query Manager 
profile (see age 40). You might also be able to 


connect to other databases using the Query Manager CONNECT statement (see page eae or SET 
CONNECTION statement (see page béa). For DRDA® considerations, see : 
The data in a table is arranged in columns and rows: 


* Columns of a table identify particular types of information. Each column of a row is related in some way 
to all the other columns for that row. A column must be of a particular data type, such as CHARACTER, 
DECIMAL, DATE, or TIME. For example, the values in a column of employee salaries would all be 
DECIMAL. Each column is identified by a column name. 


¢ Rows contain the actual data of a table. Each row is a sequence of values, one for each column of the 
table; it is a group of related data treated as a unit. The data in a row must conform to the column data 
types defined for the table. There is no inherent order of the rows within a table. 
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Table J shows a simple database table. 
Table 2. Simple Employee Table 


ID | NAME DEPT | JOB YEARS SALARY COMM 
10 | Sanders 20 | Mgr 7 18357.50 0 
20 | Pernal 20 | Sales 8 18171.25 612.45 
30 | Marenghi 38 | Mgr 5 17506.75 0 
40 | O’Brien 38 | Sales 6 18006.00 846.55 
50 | Hanes 15 | Mgr 10 20659.80 0 
60 | Quigley 38 | Sales 0 16808.30 650.25 
70 | Rothman 15| Sales 7 16502.83 1152.00 
80 | James 20 | Clerk 0 13504.60 128.20 
90 | Koonitz 42 | Sales 6 18001.75 1386.70 
100 | Plotz 42 | Mgr 7 18352.80 0 


Libraries and collections in Query Manager 


Libraries and collections are places to store objects and tables, such as the query and report form 
definitions, and the tables that you use in Query Manager. When you use Query Manager, you are often 
prompted to specify the name of the library or collection in which an object or table is stored. (This library 
or collection name is also known as a qualifier.) 


Queries, report forms, and database tables are organized into sets called /ibraries. When you create one 
of these objects, it is assigned to one library. A library groups related objects and allows you to find the 
objects by name. 


Collections are special types of libraries used to store database tables. A collection consists of a library, 
journal, journal receiver, data dictionary, and SQL catalog. Note that tables can be stored in either libraries 
or collections. 


You need to give different names to objects of the same type that are stored in the same library or 
collection. For example, you cannot have two queries, both named STAFF, in the same library. You can 
have a query, a report form, and a table all named STAFF in one library, and another table named STAFF 
in a second library or collection. See EN 9] for more 
information. 


Query Manager supports the following special libraries. You can enter these names to search the 
associated libraries or collections for objects or tables. (In the following descriptions, the word “library” is 
used to represent both libraries and collections.) 


*CURLIB 
Specifies the current library being used for your job. It is the only library searched. If no current 
library is found, QGPL (the default library) is searched. 


When you specify *CURLIB for a Library prompt, Query Manager changes it to the name of the 
library currently being used in your job. That library name is displayed in place of *CURLIB. 


*LIBL Specifies all the libraries in the library list for your current job. The libraries are searched in the 
same order as they are listed for your job. 
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Double-byte character set (DBCS) values in Query Manager 


Some countries use pictograms or symbolic characters in their language. DBCS data types must be used 
for these values. Usually, if your national language uses alphabetic letters instead of DBCS characters, 
your tables do not contain DBCS data. You can ignore any on-line help that refers to DBCS data. 


You can include DBCS characters in query definitions, and in the headings and footings for report forms. 
You can also enter DBCS characters in Query Manager tables for columns that are defined with the 
GRAPHIC or VARGRAPHIC data types. If your iSeries system is DBCS-capable, you can also enter 
DBCS oe for columns that are defined with the CHARACTER and VARCHAR data types. See 
64) for more information. 


Note: To properly display DBCS data, you need a DBCS-capable display station. 


Sort sequence capabilities in Query Manager 


Sorting and comparing character data are complex operations in query and report functions. Query 
Manager gives you four sort sequence tables to choose from when you create a query: 


* You can choose to use the hexadecimal codes of the characters in the character set you are using. 
When you use the hexadecimal codes, all the lowercase characters sort before (have lower values 
than) the uppercase characters. For example, the characters AbBa sort as abAB. The code for the 
hexadecimal sort sequence is *HEX. 


* You can choose a sort sequence table that you previously created. You can create a sort sequence 
table with the Create Table (CRTTBL) CL command. 


* You can select either of two sort sequences associated with the language that is appropriate for query. 
The two system-supplied sort sequences are: 


*LANGIDSHR 
Certain characters in this sort sequence table have the same collating weight. The uppercase 
and lowercase versions of a letter share the same value. 


*LANGIDUNQ 
All characters in this sort sequence table have unique collating weights. This table differs from 
the hexadecimal code in that uppercase and lowercase letters have collating weights adjacent 
to each other. When using this table, the lowercase characters precede the comparative 
uppercase characters. 


67| shows several examples of uses 


for the “HEX, “LANGIDSHR, and *LANGIDUNQ sort esac : 


Queries and the SQL language in Query Manager 


In general terms, a query is a question asked of the database. For example, you use a query to get 
information from database tables to produce a report. All queries created in Query Manager are written in 
the DB2 UDB for iSeries SQL language. Most of the queries you write or run will be SQL SELECT 
statements to generate reports on existing database information. Query Manager queries can contain all 
interactive SQL statements except for the CONNECT, DISCONNECT, RELEASE, and SET CONNECTION 
statements. 


The ii example shows a simple query that extracts information from the sample table shown on 
page 


SELECT DEPT, NAME, JOB, SALARY, COMM 
FROM MYCOLL.STAFF 
WHERE DEPT = 20 OR DEPT = 38 
ORDER BY DEPT, JOB 


This means: 
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¢ SELECT the values from the columns named DEPT, NAME, JOB, SALARY, and COMM 
¢ FROM the table named STAFF in the MYCOLL collection 
¢ For each row WHERE the value in the row’s DEPT column is either 20 OR 38 


* Sort the results in ORDER BY the values in the DEPT column, and within each DEPT sort in order by 
the values in the JOB column. 


The results of running this query are shown in igure 4] 


Prompted queries in Query Manager 
Users with little or no experience in using the SQL language can create_and change SELECT statement 


ueries using Query Manager’s prompted query creation mode. See 
amenEneeameree Oe an example of a SELECT statement query. 
A series of displays are shown, with prompts that ask you to enter all of the information that Query 
Manager needs to create the query. Answer the prompts shown on these displays to create a prompted 


query. 


The values that you can enter in response to the prompts are shown on the displays. Additional 
information about the prompts and values is available by pressing F1 (Help) or F4 (Prompt). 


Prompted query is started from the Work with Query Manager Queries display, by selecting one of the 
following options: 


1=Create 
(if your current query creation mode is prompted) 


2=Change 
(if the query was last saved as a prompted query) 


5=Display 
(if the query was last saved as a prompted query) 


for more information. 


Report forms in Query Manager 


While a query is a question asked of the database, a report form specifies the format of the answer. The 
report itself is the result of applying a report form to the data generated by running a query. 


If you run the example query shown on page 4 without specifying a report form, Query Manager generates 
a default report form and produces a simple report, as shown in Houma This default report form is 
referred to as *SYSDFT, the system default form. 


DEPT NAME JOB SALARY COMM 
20 James Clerk 13504 .60 128.20 
20 Sanders Mgr 18357 .50 0 
20 ~=—Pernal Sales 18171.25 612.45 
38 Abrahams Clerk 12009.75 236.50 
38 Naughton Clerk 12954.75 180.00 
38 Marenghi Mgr 17506.75 0 
38 O'Brien Sales 18006 .00 846.55 
38 Quigley Sales 16808 .30 650.25 


Figure 1. Report Using Default Report Form 
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Making reports easier to read in Query Manager 

You can improve the presentation of the report by creating a report form and applying it to the query data. 
The report form could specify a page heading and footing, and column headings that are more descriptive, 
as shown in 


Employee Earnings< Page heading 
Employee 
Department Name Job Salary Comission «—Column heading 
at la =o woctcrto 0 wnn------ <«—Heading 


20 James Clerk 13504.60 128.20 separators 
20 Sanders Mgr 18357 .50 0 

20 Pernal Sales 18171.25 612.45 

38 Abrahams Clerk 12009.75 236.50 «—Detail line 
38 Naughton Clerk 12954.75 180.00 

38 Marenghi Mgr 17506.75 0+ 
38 O’Brien Sales 18006.00 846.55 +——Detail line 
38 Quigley Sales 16808.30 650.25 spacing 


4 tt 


Column indent 
Column width 
Page 1«—————_ Page footing 
RBAL3515-1 


CONFIDENTIAL 


Figure 2. Report Using Simple Report Form 


Using break levels in the report in Query Manager 

You can further improve the presentation of the report by including break levels in the report form. You use 
break levels (also known as report breaks and control breaks) to separate the report information into 
meaningful groups. For each break group, you can specify descriptive text and calculate totals, averages, 
and other summary values. 


For example, you can improve on the report shown in Figure 2 on page 4 using the following formatting 
options: 


* Cause a break to occur when the department number changes 
¢ Print a break heading and footing for each department 

* Total the salaries and commissions for each department 

* Cause a second break to occur when the job value changes 

¢ Print a break footing for each job 

* Total the salaries and commissions for each job 

¢ Print final text and grand totals at the end of the report 


In Figure 3 on page 7) a high-level break, BREAK1, is specified for the DEPT column. The break is 
defined so that whenever the department number changes, the summary details are displayed (in this 
case, the total salaries and commissions for the department). 


A second-level break, BREAK2, is specified for the JOB column. The second break is defined so that 
whenever the job type changes, the summary details are displayed (the total salaries and commissions for 
employees of that job type within that department). 


Notes: 


1. When using break levels, sort the row data into an order that is logical for the breaks. For example, if 
you want the report to break when the value in the DEPT column changes, you should sort the row 
data by DEPT. That means all departments will be grouped together (as you specify in either 
ascending or descending order of the sorting sequence). If you are creating or changing an SQL query, 
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you sort row data using the ORDER BY clause of the SELECT statement. If you are creating or 
changing a prompted query, you sort row data using the Select Sort Columns display. 


2. Columns for which you specify break levels are not automatically shown on the left of the report, and 
the columns for which you specify summaries are not automatically shown on the right. To make your 
report more readable, you can specify a column sequence in the report form definition so that break 
columns appear on the left of the report, and columns with summary data appear on the right. 


Eigure 4 shows two break levels, and the features described on page al 


Employee 
Department Name Job Salary Comission 


Beginning of department 20< BREAK1 heading 
20 James Clerk 13504.60 128.20 <BREAK2 


separators 
Total for job Clerk <—13504.60 128.20 <BREAK2 summary 


BREAK2 footing 


Sanders Mgr 18357 .50 0 


Total for job Mgr 18357.50 0 
Pernal Sales 18171.25 612.45 


Total for job Sales 18171.25 612.45 


Seo Soe osease Senco <-BREAK1 separators 
Total for department 20<¢— 50033.35 740.65 ¢BREAK1 Surmiary 


BREAK1 footing 


Beginning of department 38 
38 Abrahams Clerk 12009.75 236.50 
Naughton Clerk 12954.75 180.00 


Total for job Clerk 24964 .50 416.50 
Marenghi Mgr _17506.75 
Total for job Mgr 17506.75 0 


O’Brien Sales 18006.00 846.55 
Quigley Sales __16808.30 650.25 


Total for job Sales 34808.30 1496.80 


Total for department 38 77285.55 1913.30 
SSSssssesssssssssss=¢ Final separators 

Grand Total -- +H 127318.90 2653.95 «Final summary 

Employee Salaries < Final text 


RBAL3514-1 


Figure 3. Report Using Report Form with Two Break Levels 


an formatting is described in detail in 


Active query in Query Manager 


The active query is the last query that was created, changed, or run in the current Query Manager 
session. Query Manager uses the active query as the default when you choose to run a query or report. 


When you create or change a query, you are always prompted to save it before any action is processed 
that would otherwise cancel or replace the query. Note that a query run as the result of running a 
procedure does not change the active query. 
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Active form in Query Manager 


The active form is the last report form that was created, changed, or used to produce a report in the 
current Query Manager session. Query Manager uses the active form as the default when you choose to 
run a query or report. 


When you create or change a report form, you are always prompted to save it before any action is 
processed that would otherwise cancel or replace the report form. Note that a report form used to produce 
a report as the result of running a procedure does not change the active form. 


Active data in Query Manager 


The active data is the data most recently retrieved from a database as the result of interactively running an 
SQL SELECT statement query or prompted query. Active data is useful when you create or change a 
report form, and when you display or run a report. 


When you create or change a report form, active data can provide default values for the column 
formatting, such as column headings and widths. You can also use the active data to display the report. 
You do not need to run a query each time you want to see how the report formatting values are affecting 
the appearance of the report. Run the query once to create active data; then when you display the report, 
Query Manager formats the active data using the report form, as long as the active data matches the 
report form. For the active data to match the report form, they need to contain the same number of 
columns, and the columns need to have compatible data types. 


You can also use active data to run a report. When you select option 9 (Run report) from the Work with 
Query Manager Report Forms display, a prompt display asks you either to enter the name of the query 
you want to run, or to specify that you want to produce the report using the active data. You do not need 
to re-run a query if active data already exists. 


The active data is not necessarily related to the active query. For example, you might first run query A. 
Query A becomes the active query and active data is produced. If you then choose to change query B, 
query B becomes the active query, but the active data remains unaffected because no new query has yet 
been run. 


Active data is not affected when: 

¢ You run an SQL query that does not contain a SELECT statement 

¢ You run an SQL SELECT statement query or prompted query in batch mode 

¢ An SQL SELECT statement query or prompted query is run as the result of running a procedure 


Sample active data in Query Manager 

Active data is created when an SQL SELECT statement query or prompted query is run interactively. 
Some queries take a long time to run: for example, those that are complex or retrieve a large number of 
rows from the database. If you do not require full active data, you can save time by running these queries 
using the sample restriction, and create sample active data. 


When you run an SQL SELECT statement query or prompted query, you can specify that you want it to 


retrieve a sample number of rows only. You specify the number of rows to include in the sample (between 
1_and oy ea eg Query Manager profile (see 
. Sample queries are always run in interactive mode. The sample active data that 


results from_a query run in this way is always output to display; it cannot be printed or written to another 
ge 9 for more information. 


Note: If “Allow interactive sample run” is set to NO in your Query Manager profile, you cannot run queries 
using the sample restriction. See page Bal for more information. 
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Incomplete active data in Query Manager 

There may be times when you expect to run a full SQL SELECT statement query or prompted query, but 
you end up with incomplete data. This is not the same as sample data. When you run queries interactively, 
a limit can be placed on the maximum number of rows that can be retrieved from the database. ans limit 


is determined PY your auery Manager profile. See [Max 


If Query Manager retrieves the maximum number of rows before it completes the query, a message 
appears at the bottom of the display informing you that: 
Maximum number of records reached. Data is incomplete. 


When this happens, final summary functions such as SUM, AVERAGE, and COUNT are omitted from your 
report. 


Sample queries and sample reports in Query Manager 


When you run an SQL SELECT statement query or prompted query, you can choose to retrieve from the 
database either all of the rows specified by the query, or a limited number of rows (a sample). You set the 
sample number of rows you want to retrieve (between 1 and 100 tnteuon your Query Manager profile. 


When you do not require full active data, you can save time by running queries using the sample 
restriction, and creating sample active data. Sample queries are always run in interactive mode. The 
output from a sample query or report is always shown on your display; it cannot be printed or written to 
another table. 


Note: If “Allow interactive sample run” is set to NO in your Query Manager profile, you cannot run queries 
or reports using the sample restriction. See page 3d for more information. 


Sample reports are produced when you apply a report form to data retrieved by a sample query. Sample 
reports are useful when the main purpose for producing the report is one of the following: 


* To confirm that the data selected by a particular query is the correct data for your purpose 
* To see how a particular report form arranges the report data 


Sample queries and reports can be run and displayed in several ways: 


¢ Run a query by choosing option 9 (Run) from either the Work with Query Manager Queries or (Run 
ee Work with Query Manager Report Forms display, and set “Run sample only” to YES (see page 


¢ Press F6 (Run sample) from any of the following displays: 
— Edit Query or Display Query display 
— Any Define Prompted Query or Display Prompted Query display 


(See pages sd and Kal) 


¢ Press F5 from any of the Select Report Format or Display Report Format displays where that key is 
labeled (Display sample) rather than ee ae el or (Run report). This happens when the active data 
is the result of a sample query (see pages and ). 


¢ Press F5 from any of the Select Report Format or Display Report Format displays where that key is 
labeled (Run report) rather than (Display report) or (Display sample). This happens when there is no 
active data. Set “Run sample only” to YES (see pages Tr, and ). 


* If “Display run options” is set to YES in your Query Manager profile, press F5 (Run report) from any of 
the following displays; then set “Run sample only” to YES: 


— Edit Query or Display Query display 
— Any Define Prompted Query or Display Prompted Query display 


(See pages 5d, al and 44.) 
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* Issue the DISPLAY SAMPLE statement on the Query Manager statement line (see page B51). 


Note: When you run a query or report using the sample restriction, final summary functions such as SUM, 
AVERAGE, and COUNT are omitted from your report. 


Procedures in Query Manager 

You use procedures to run a set of Query Manager statements with a single RUN statement. You might 
find yourself running queries and producing reports over and over again that use the same Query Manager 
statements. If you do, consider running these steps together by creating a procedure. 


The following example illustrates a procedure called PAYROLL. 


"RUN QUERY PAYROLL' 
‘PRINT REPORT (FORM=PAYFORM' 
"SAVE DATA AS MYCOLL.PAYSUM' 


This procedure runs the PAYROLL query, prints a report using the PAYFORM report form, and saves the 
data to a table called PAYSUM in the MYCOLL collection. 


Procedures are created and changed outside Query Manager, using a Source Edit Utility (SEU) editor. 
When you create a procedure to run from Query Manager, the following guidelines apply: 


¢ Each Query Manager statement must be typed in uppercase. 

¢ Procedures can contain only Query Manager statements, blank lines, and comment lines that are 
delimited by /* and */. Blank lines and comment lines have no effect on statement processing. 

* Procedures can contain a RUN statement that runs another procedure or a query. 

* The query statements within a procedure must be delimited by ‘single’ or “double” quotation marks. 


Use the RUN PROC statement to run the procedures (see page 1259). Users with an ALL access level can 
enter the RUN PROC statement on any Query Manager statement line. The statement line is available 
from most displays by pressing F22 (QM statement). 


Notes: 
1. Running a procedure does not affect the active query, active form, or active data. 


2. When you run a procedure in batch mode, Query Manager uses the default job description specified in 
your Query Manager profile to set the environment. 


Query Manager and relationships to other iSeries products 


There are several data manipulation tools that have, to some extent, overlapping functions. For querying 
data, you can use Query Manager, DB2 UDB for iSeries SQL, Query for iSeries, DB2 UDB for iSeries 
Query Management, and the Open Query File (OQPNQRYF) command. 


The following information describes the differences between these tools and indicates their likely uses. 


DB2 UDB for iSeries SQL 
Programmers use the DB2 UDB for iSeries SQL language to query and manipulate data in a 
database. Most SQL functions can be performed either interactively or in application programs 
written in a high-level programming language. The query component can be used in programs to 
read data for further processing by other high-level language statements. Interactive SQL can also 
be used by programmers to test SQL statements that are to be embedded in a program. 


Query Manager 
This tool allows easy reporting on database information. It is the interface for using the DB2 UDB 
for iSeries SQL language and OS/400 Query Management. Query Manager provides three 
integrated interfaces for the creation and maintenance of queries, report forms, and database 
tables. 
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Query for iSeries 
This tool allows easy reporting on database information. It is not built on the DB2 UDB for iSeries 
SQL language. One feature unique to Query for iSeries is the option of merging data into 
OfficeVision/400* documents. 


DB2 UDB for iSeries Query Management 
This is an application programming interface to the Query Management Common Programming 
Interface (CPI). CPI functions are provided by Query Management. The CPI allows a user to 
access information in a relational database and control how this data appears when formatted into 
a report. The CPI provides services that fall into two major categories: querying and report writing. 


Open Query File (OPNQRYF) Command 
This is a programming command that can be used with a high-level language program. It acts as a 
filter between the program and the database, so that the program receives only those records that 
meet the criteria specified in the OPNQRYF command. It is not built on the DB2 UDB for iSeries 
SQL language. 
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Chapter 2. Getting Started with Query Manager 


This chapter tells you how to get Query Manager up and running. It begins with instructions on how to 
start up and exit from Query Manager, and describes the main menu and its options. Following this is a 
description of Query Manager displays in general, including instructions on how to select options from 
displays and objects from lists, and how to enter information. Next, the online help available is described, 
which includes help for messages, and the job log. The commonly used function keys are also described. 


You can then read about the prompt and error messages shown on Query Manager displays: when and 
why these messages appear, and what you should do when you see them. This is followed by a 
description of the Query Manager command window, through which you can enter Query Manager 
statements and system commands. 


This chapter finishes with a description of the naming conventions to use when saving your Query 
Manager queries, report forms, and tables. 


Starting DB2 UDB for iSeries Query Manager 


You need to have authority to use the STRQM command before you can use Query Manager. Start Query 
Manager by typing STRQM on any command line, or by selecting the Query Manager option from one of 
the following menus: 

* Query Utilities menu 

¢ SQL Commands menu 

* Query Commands menu 

¢ Start Commands menu 


If the “Relational database connection” setting in your Query Manager profile is other than *NONE or 
*CURRENT, you are connected to the specified database before Query Manager starts. If the specified 
database connection is on a remote system, a display prompts you to enter the user ID and password for 
the connection. See 48 for a description of the values you can 
enter. 


Note: If the remote connection fails, you cannot use Query Manager. Ask the security administrator to 
change the “Relational database connection” setting in your Query Manager profile. If you have 
*SECADM authority and the remote connection fails, you can start Query Manager using your local 
database connection, so you are always able to change users’ profile settings. 


When you successfully start Query Manager, the main menu is displayed. (An example of the main menu 

is shown in SEMCEWSNSe CCR I This menu and its options are described over the next few pages. From 

the main menu, you can select the following: 

* Work with Query Manager queries to create, change, copy, delete, display, print, and rename query 
definitions, to run queries, and to convert prompted query definitions to SQL query definitions. 

¢ Work with Query Manager report forms to create, change, copy, delete, display, print, and rename 
report forms, and run (produce) reports. 

* Work with Query Manager tables to create, copy, delete, display, rename, display the definition of, add 
data to, change data in, display data in, and print data from tables. 


* Work with Query Manager profiles to view, change, and copy your Query Manager profile. 


4| for a description of the main menu, and 


instructions telling you how to select menu items. 
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Exiting from Query Manager 


When you finish working with Query Manager, you exit from the main menu by pressing F3 (Exit) or 
F12 (Cancel). Either one of these keys takes you out of Query Manager, and returns you to the display 
you were using before you started Query Manager. 


Using the main menu in Query Manager 


The first display you see when you start Query Manager is the main menu. An example of the Query 
Manager main menu is shown in 


i > 
DB2 Query Manager for AS/400 
System: ABC400A 


Select one of the following: 
1. Work with Query Manager queries 
2. Work with Query Manager report forms 


3. Work with Query Manager tables 


10. Work with Query Manager profiles 


Selection 
Tq 


nee F12=Cancel F22=QM Statement 


Figure 4. Main Menu Display 


Each menu option takes you to a “Work with” display, from which you can perform a number of options. To 
go to a “Work with” display, type the number that corresponds to the display you want to use in the 
Selection prompt at the bottom of the display; then press the Enter key. 


When you go to a “Work with” display, you have the authority to use all of the options and function keys 
that are shown on the display. The options and function keys shown differ depending on whether you are a 
security administrator, and whether you have a BASIC or an ALL access level. Access levels are set 
through the Query Manager profile, and are described on pages Bal and ka. Security administrator 
authority is assigned outside Query Manager, and is described in iSeries Security Reference. 


Note: The main menu shows only those options that you have the authority to use. Your access to the 

Work with Query Manager tables option can be restricted through your Query Manager profile. If 

“Allow access to QM tables option” is set to NO, option 3 (Work with Query Manager tables) is not 

shown in ine main menu, and you cannot access the Work with Query Manager Tables display. See 
on page 44 for more information. 


The work with Query Manager queries display 


In general terms, a query is a question asked of the database. For example, you use a query to get 
information from database tables to produce a report. 


Choose option 1 from the main menu to go to the Work with Query Manager Queries display. If you have 
an ALL access level, you can perform the following options through this display: 
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¢ Create a query. Shows the Edit Query display if your current query creation mode is SQL. SQL queries 
can contain any SQL statement that you have been granted authority to use through your Query 
Manager profile. 


Shows the Define Prompted Query display if your current query creation mode is prompted. A series of 
displays prompt you to enter all of the information that Query Managerneeds to create the query. 


* Change a query. Shows the specified query in either the Edit Query display, or the Define Prompted 
Query display, depending on the mode in which the query was last saved. You can change the query 
definition through this display. 


* Copy a query. Copies a query. You can replace an existing query or create a new one. 


* Delete a query. Deletes queries you no longer require. You need to respond to a confirm display before 
the delete occurs. 


* Display a query definition. Shows the definition of the specified query in display-only format. The 
query definition is shown in the format in which it was last saved, either SQL or prompted. You cannot 
change any values through this option. 


¢ Print a query definition. Sends a copy of the SQL statement that defines the query to the printer 
specified in your Query Manager profile. 


¢ Rename a query. Prompts you to specify new names for existing queries. 


¢ Run a query. Runs the selected query. You can run promptedqueries, and any SQL queries that contain 
one of the SQL statements that you have been granted authority to use through your Query Manager 
profile. If the query is: 


— An SQL SELECT statement or prompted query, Query Manager shows a run options display, 
prompting you to specify options such as the mode in which you want to run the query (batch or 
interactive), and the destination to which you want the query output directed (printer, display, or 
table). Run options are described in detail on page 


— Not an SQL SELECT statement, Query Managershows a Run Query display, prompting you for the 
mode (batch or interactive) in which you want to run the query. 


* Convert to SQL. Converts a prompted query to an SQL query. You can replace the existing prompted 
query definition with the converted SQL query, or you can create a new SQL query, and leave the 
prompted query definition unchanged. You need authority to use the SQL query creation mode and the 
SELECT statement. 


Users with a BASIC access level can display a query definition, print a query definition, and run a query 
through the Work with Query Manager Queries display. 


The work with Query Manager report forms display 


While a query is a question asked of the database, a report form specifies the format of the answer. The 
report itself is the result of applying a report form to the data generated by running a query. 


Choose option 2 from the main menu to go to the Work with Query Manager Report Forms display. If you 
have an ALL access level, you can perform the following options through this display: 


* Create a report form. Shows the Select Report Format displays, through which you can create a report 
form. Specify the headings, footings, formatting, breaks, summary functions, and spacing. 


¢ Change a report form. Shows the specified report form in the Select Report Format displays. You can 
change the definition of an existing report form through these displays. 


¢ Copy a report form. Copies a report form. You can replace an existing report form or create a new 
one. 


* Delete a report form. Deletes report forms you no longer require. You need to respond to a confirm 
display before the delete occurs. 
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* Display a report form definition. Shows the definition of a report form in display-only format. You 
cannot change any values through this option. 

¢ Print a report form definition. Sends a copy of the report form definition to the printer specified in your 
Query Manager profile. 

¢ Rename a report form. Prompts you to specify new names for existing report forms. 

¢ Run a report. Produces a report by applying the selected report form to the active query data. Query 
Manager shows a run options display, prompting you to specify options such as the query you want to 
run to generate the report data, and the mode in which you want to run the query (batch or interactive). 
Run options are described in detail on page 


Users with a BASIC access level can display a report form definition, print a report form definition, and run 
a report through the Work with Query Manager Report Forms display. 


Report forms are described in detail in { 


The work with Query Manager tables display 


You use Query Manager tables to add to and maintain information in the database. Users with BASIC and 
ALL access levels can create tables and add information to them. Table information can later be 
manipulated, printed, and viewed through the Tables, Queries, and Report Forms options. 


Choose option 3 from the main menu to go to the Work with Query Manager Tables display. All Query 

Manager users have access to all of the options shown on this display, and can perform the following 

options: 

* Create a table. Shows the Create Query Manager Table display, through which you can create a table. 
Type a description for the table; then specify the name, data type, length, and number of decimal places 
for each of the columns you want to include in the table. 


* Copy a table. Copies a table. You can replace an existing table or create a new one. You can copy the 
table definition only, or copy the definition and the data rows. If required, you can change the definition 
of the table during the copy. 


* Delete a table. Deletes tables you no longer require. You need to respond to a confirm display before 
the delete occurs. 


¢ Display a table. Prompts you to specify search conditions to find the rows you want to display; then 
shows the selected rows in a display report. Information is shown in display-only format. You cannot 
change any values through this option. This option is not shown if you are running Query Managerin 
batch mode (see 


¢ Print a table. Prompts you to specify search conditions to find the rows you want to print; then prints 
the selected rows in a report. The table information is printed using the default printer and run query 
mode from your Query Manager profile. 


* Rename a table. Prompts you to specify new names for existing tables. 


¢ Display table definition. Shows the definition of a table in display-only format. You cannot change any 
values through this option. 

¢ Add data to table. Shows a data entry display, through which you can add data rows to a selected 
table. 

* Change data in table. Prompts you to specify search conditions to find the rows you want to change; 
then shows the selected rows one at a time in a data entry display. Using this option you can change 
row data, and delete entire rows. 

* Display table data. Prompts you to specify search conditions to find the rows you want to display; then 
shows the selected rows one at a time in display-only format. You cannot change any values through 
this option. 
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Note: Not all users can access the Work with Query Manager Tables display. If “Allow access to QM 
tables option” is set to NO in your Query Manager profile, the Work with Query Manager tables 
option is not shown on the main menu. See page 44 for more information. 


Query Manager tables are described in detail in 


The work with Query Manager profiles display 


Your Query Manager profile is the portion of your iSeries user profile that contains the settings and default 
values used when you run Query Manager. Query Manager creates a default Query Manager profile the 
first time you use the system. Your security administrator can change the settings contained in your profile, 
and as you become familiar with Query Manager, you might also want to change some of the values. 


The values you can change in your Query Manager profile differ depending on whether you have a BAS/C 
or an ALL access level. Query Manager user access levels are described on page B23. 


Choose option 10 from the main menu to go to the Change Query Manager Profile display. You can 
change all of the information shown on this display except for your iSeries user profile name and 
description. 


Press F10 (Display additional details) to view the rest of the settings and values that make up your Query 
Manager profile. This information is shown in display-only format. You cannot change any of the values 
shown on the Additional Details display. Only the security administrator has the authority to change these 
settings and values. 


Security administrator options in Query Manager 

If you have security administrator (“SECADM) authority, you can work with the profiles of other Query 
Manager users. When you choose option 10, you go to a Work with Query Manager Profiles display, 
through which you can perform the following options: 


¢ Change a profile. Shows the Change Query Manager Profile display, through which you can change 
the settings and default values in a Query Manager profile for which you have *OBJMGMT rights. 


* Copy a profile. Copies a Query Manager profile. You can create a new profile or replace an existing 
one with the settings and values from another selected profile. You need to have *OBJMGMT rights for 
both the profile you want to copy from and the profile you want to copy to. If you are creating a profile, 
the person you are creating the profile for must have a user profile on the system (created using the 
CRTUSRPRF CL Command). 

* Display a profile. Shows a Query Manager profile in display-only format. You cannot change any 
values through these displays. You need to have *READ rights for the profile you want to display, but 
you do not need *OBJMGMT rights to display a Query Manager profile. 


Query Manager profiles are described in detail in (Chapte 


*SECADM authority, “OBJMGMT rights, and *READ rights are assigned outside Query Manager, and are 
described in iSeries Security Reference. 


Using Query Manager displays 
All Query Manager displays show instructions telling you how to use them. Simply follow the instructions 
shown on the display. For example: 

Type choices, press Enter. 

Type SQL statement. 

To rename table, type New Name, press Enter. 
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If you are ever unsure how you should use a display, press F1 (Help). Help information is available 
throughout Query Manager, and provides you with additional information for an entire display, or for any 
value, prompt, or message that you may not understand completely. 


Query Manager knows what your profile access level is, and displays only those options and function keys 
that you have the authority to use. To choose an option from an Query Manager display, type its number in 
the Selection or Opt prompt shown on the display; then press the Enter key. 


When you see More... in the bottom right-hand corner of a display, it means that there is more information 
to display. Use your display station’s roll keys to view the rest of the display information. When you reach 
the end of the information, you see Bottom displayed instead of More... 


Many Query Manager displays show lists of items that you can use to complete prompts. These items 
might include: 

* Queries, report forms, and tables you are authorized to use 

* SELECT statement options 

¢ Report formatting options 

* Valid data types for tables 

* Available printers 


These lists eliminate the need to memorize names, and reduce the number of potential typing errors. 
Many lists are displayed only when you press F4 (Prompt). 


Most lists have Opt prompts that you use to make selections directly from the list. Simply move the cursor 
to the Opt prompt next to the item you want to select; then type the number that corresponds to the option 
you want to perform. The available options you can perform are shown on the display, usually at the top of 
the list. 


Making selections from different types of lists is described on pages isl and 21. 


Entering information through a display in Query Manager 


Prompts (shown as underlines) are Query Manager’s way of asking you what it needs to know in order to 
fulfill your request. You need only “fill in the blank”. Often the prompt even lists the possible correct 
choices, so you need only type the choice that fits what you are doing. If you are not sure what 
information you are supposed to supply at a prompt, you can move the cursor to the prompt and press 
F1 (Help). In some cases you can also press F4 (Prompt) for a list of valid selections. 


When some entry displays are shown, some of the prompts are already filled in. These filled-in values are 
called default values: they are the values assumed by the system if you do not specify anything yourself. 
You can leave a default value the way it is, or if you want, you can change it to another value. Simply 
move the cursor to the prompt, and type a new value over the default value. 


Prompts are Query Manager’s way of identifying an input field. You can change any values you see that 
are underlined. 


Using “Work with” display lists in Query Manager 


When you choose to work with queries, report forms, or tables from the main menu, Query Manager 
shows a “Work with” display. This display lists the options you can perform, followed by a list of the 
queries, report forms, or tables you can choose. 
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Work with Query Manager Tables 
IDNA Gen eee eb th Sees os, Ses MYCOLL Name, F4 for list 


Type options, press Enter. 
l=Create table 3=Copy table 4=Delete table 5=Display table 
6=Print table 7=Rename table 8=Display definition 9=Add data 
10=Change data  11=Display data 


Opt Table Description 
1 STAFF 

APPLICANT Table of job applicants 

CARS Sample CARS Table 

EMPLOYEE Personnel in each in each department 

ORG Corp.'s organization information 

PRODUCT Description of corp. products 

SCREENS Output file for STRCPYSCN 

VENDINFO Vendor Information 

Bottom 

F3=Exit F4=Prompt F5=Refresh F1l=Display table only  F12=Cancel 


Fl6=Repeat position to F17=Position to F24=More keys 


Figure 5. A “Work with” Display 


To make a selection from a “Work with” display list, move the cursor to the Opt prompt next to the name of 
the query, report form, or table you want to choose; then type the option number that corresponds to the 
option you want to perform. You can also type the option number in the Opt prompt at the top of the list, 
next to the blank object name; then type the name of the query, report form, or table you want to choose. 


To create a new object, type 1 (Create) in the Opt prompt at the top of the list, next to the blank name; 
then type the name of the query, report form, or table you want to create. 


Rules for system name generation in Query Manager 


There are specific instances when the system generates a system table or column name. These instances 
and the name generation rules are described in the following sections. 


Rules for column name generation in Query Manager 
A system-column-name is generated if the system-column-name is not specified when a table or view is 
created and the column-name is not a valid system-column-name. 


If the column-name does not contain special characters and is longer than 10 characters, a 10-character 
system-column-name will be generated as: 


¢ The first 5 characters of the name 
* A5 digit unique number 


For example: 
The system-column-name for LONGCOLUMNNAME would be LONGCOQ0001 


lf the column name is delimited: 


¢ The first 5 characters from within the delimiters will be used as the first 5 characters of the 
system-column-name. If there are fewer than 5 characters within the delimiters, the name will be 
padded on the right with underscore (_) characters. Lower case characters are folded to upper case 
characters. The only valid characters in a system-column-name are: A-Z, 0-9, @, #, $, and _. Any other 
characters will be changed to the underscore (_) character. If the first character ends up as an 
underscore, it will be changed to the letter Q. 


¢ A 5 digit unique number is appended to the 5 characters. 
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For example: 


The system-column-name for "abc" would be ABC__00001 
The system-column-name for "COL2.NAME" would be COL2_00001 
The system-column-name for "C 3" would be C_3_ 00001 
The system-column-name for "??" would be Q 00001 
The system-column-name for "*column1" would be QCOLU00001 


Rules for table name generation in Query Manager 
A system name will be generated if a table, view, or index is created with either: 


¢ Aname longer than 10 characters 
¢ Aname that contains characters not valid in a system name 


Either the SQL name or its corresponding system name may be used in SQL statements to access the file 
once it is created. However, the SQL name is only recognized by DB2 UDB for iSeries and the system 
name must be used in other environments. 


If the name does not contain special characters and is longer than 10 characters, a 10-character system 
name will be generated as: 


¢ The first 5 characters of the name 
¢ A5 digit unique number 


For example: 
The system name for LONGTABLENAME would be LONGTOQ001 


If the SQL name contains special characters, the system name is generated as: 
° The first 4 characters of the name 

* A4 digit unique number 

¢ All special characters are replaced by the underscore (_) 

¢ Any trailing blanks are removed from the name 


* The name is delimited by double quotes (”) if the delimiters are required for the name to be a valid 
system name. 


For example: 


The system name for "??" would be "_ 0001" 

The system name for "longtablename" would be "longQ001" 
The system name for "LONGTableName" would be LONGOO0O1 
The system name for "A b  " would be "A_b0001" 


SQL ensures the system name is unique by searching the cross reference file. If the name already exists 
in the cross reference file, the number is incremented until the name is no longer a duplicate. 


Specifying multiple options in Query Manager 

You can choose more than one object at a time, by specifying either the same option for multiple objects, 

or multiple options for multiple objects. For example, from a single “Work with” display, you can choose to 

delete multiple objects, or you can choose to copy three objects, delete one object, and display two more. 

The only exception is that you can specify only one option 1 (Create). When you choose to work with 

multiple objects, Query Manager deals with them in the following order: 

¢ If you specified a Create, the Create is performed first. 

* Following that, the options are performed in the same order as the object names appear in the “Work 
with” display list. 
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¢ When Query Manager comes to the first object for which you have chosen Copy, Rename, Delete, or 
Convert to SQL, it looks for all other objects for which you have chosen the same option. Confirmation 
for all copies, renames, deletes, and conversions is performed at the same time on a single Query 
Manager display. 


If the object you want to choose is not currently shown in the display list, you can use your display 
station’s roll keys, F17 (Position to), F16 (Repeat position to), or F11 (Display name only) to change the 
portion of the list shown on the display. F17 prompts you to specify a new object name from which to 
begin the list, F16 repeats the most recent “Position to” you performed, and F11 hides the descriptions of 
the objects, and shows multiple columns of object names across the display. See TERRI Eee 


3 for more information. 


Gla ON _K ON DaAQE 


All of the objects shown in the display list are those stored in the library or collection shown at the top of 
the display. If you have an ALL access level, the library or collection name is underlined, indicating that 
you can change this value. You can type a new library or collection name over the existing name if you 
want to access objects from a different library or collection. Move the cursor to the library or collection 
prompt; then press F4 (Prompt) for a list of all of the libraries or collections that you can select. 


Using F4 (Prompt) lists in Query Manager 
When entering information on a display, you often see messages telling you to press F4 (Prompt) for a list 


of the possible values you can enter in response to a specific prompt. An example of an F4 (Prompt) list 
that displays the valid data types for Query Manager tables is shown in Eiguiadl 


= 
Create Query Manager Table 
Select Data Type 
Type option, press Enter. 
1=Select 
Opt Type Description 
BIGINT Big integer 
BLOB Binary large object 
CHARACTER Any character 
CLOB Character large object 
DATALINK Datalink 
if DATE Date 
More... 
F12=Cancel 
Bottom 
F3=Exit F4=Prompt F5=Refresh F6=Insert line  F10=Copy line 
F12=Cancel Fl4=Delete line F19=Add data F24=More keys ) 


Figure 6. Example of an F4 (Prompt) List 


You need to position the cursor on the prompt to which the F4 (Prompt) information applies before 
pressing F4. 


Many of the F4 (Prompt) lists are more than one window in length. When you see More... displayed in 


the lower right-hand corner of the window, you can use your display station’s roll keys to display the rest of 
the prompt information. When you come to the end of the list, Bottom is displayed instead of More... 
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To make a selection from the list, move the cursor to the Opt prompt next to the value you want to choose, 
and type 1. Then press the Enter key to exit from the prompt window and return to the display you were 
using when you pressed F4. The value you choose through the prompt window is inserted into the input 
prompt from which you pressed F4 (Prompt). 


Using help and online information in Query Manager 


The following online information is available on the iSeries system. After pressing F1 (Help) on any 
display, you can press F1 a second time to see an explanation of how the online information works. Read 
through this online help information using your display station’s roll keys to access the additional displays 
of information. To print a copy of the “How to Use Help” information, press F9 (Print). 


Help for displays in Query Manager 


You can press F1 (Help) at any time to see information about the current display. There are two types of 
help available: 


* Context-sensitive 
¢ Extended 


Context-sensitive help explains the value on which the cursor is positioned when you press F1 (Help). 
For example, it can describe the choices available for a prompt or explain a specific value. If a message 
appears at the bottom of the display, you can position the cursor on the message and press F1 (Help) to 
display an explanation of the message and the appropriate action to take. 


Extended help explains the purpose of the current display. Extended help appears if you press F1 (Help) 
when the cursor is outside the areas for which context-sensitive help is available, or if you press 
F2 (Extended help) when a context-sensitive help window is shown. 


a = 
Display Query Manager Table Definition 
Table. 2s 6 se ee STAPF 
Description ....: The STAFF Table 
Decimal 
Column Type Length Places 
ID INTEGER 
NAME CHARACTER 9 
DEP. i Sunn NNRersyccucrecvcttisystaretstrcy starve va erenneustVevers rede casie stele cua utiye nm afereay scares 
JOB H Type - Help ‘ 
YEARS : 
SALARY : The data type used in the specified column. 


COMM : This value is display-only. 
3 Bottom 

F2=Extended help F10=Move to top 

F1l=InfoSeeker F12=Cancel F24=More keys 


Bottom 
Press Enter to continue. 


es F12=Cancel F22=QM statement 


Figure 7. Example of Context-Sensitive Help 


Help for messages in Query Manager 


Whenever you see a message at the bottom of the display that you do not fully understand, you can 
display help information by positioning the cursor on the message and pressing F1 (Help). 
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Message help describes the reason the message was displayed, and if applicable, lists the steps you need 
to perform to correct any problems. If the message was displayed due to problems of a technical nature, a 
technical description is also shown. 


Some messages suggest that you check the job log for more information. The job log lists the operations 
performed by the iSeries system leading up to the message being displayed, including all messages that 
were displayed by Query Manager. To view job log information, press F10 (Display messages in job log). 


When you finish viewing message help information, press F3 (Exit) to return to the display from which you 
started message help. 


For more information, see [Me 


Using Query Manager function keys 


Function keys such as F1 (Help) can be used at any time from any Query Manager display; however, not 
all function keys apply to all displays. At the bottom of each display is a list of the function keys that are 
commonly used with that display (all of the available keys might not be shown). If you want to know how 
all of the available keys for a particular display work, move the cursor to the function key section of the 
display; then press F1 (Help). 


Commonly used function keys in Query Manager 


The following function keys are used fairly consistently throughout Query Manager. Their use is described 
here and not repeated for every display in which they apply. Where one of these keys is used in a different 
way, its use is described at the relevant point in this guide. 


F1 Help. Displays help information. If the cursor is positioned on a prompt or message, the help 
information is context-sensitive. Otherwise, the help describes the current display. 


F2 Base keys/Alternate keys. Displays alternate titles for function keys. The F2 key is active when a 
function key has more than one definition. For example, on the Edit Query display the F5 key 
performs two functions, (Run report) and (Refresh). The function key title that is currently shown 
on the display is the function that is active. 


F3 Exit. Exits from the current display or option, and returns to the calling display. In most cases, any 
information you have added or changed on the current display is discarded. However, if you were 
creating or changing a query or report form, F3 takes you to an Exit display. 


F4 Prompt. Displays a prompt window containing additional information about the current input 
prompt, usually in the form of a list. You can choose any value from this list by typing 1 in the Opt 
prompt next to the value you want to use. Prompt is context-sensitive. You need to position the 
cursor on the input prompt to which the information applies before you press F4. When you press 
F4 from the Edit Query display or the command window, Query Manager shows the syntax of 
supported Query Manager statements or system commands. 


F5 Refresh. Refreshes the current display, showing all of the values it contained the last time it was 
saved. (Information is usually saved by pressing the Enter key.) Use this key to discard the 
changes made to the display since the last time you pressed the Enter key. 


F5 Run report. Produces a report using the active query and the active form. If there is no active 
form, Query Manager applies a default report form to the query data. If “Display run options” is set 
to YES in your Query Manager profile, or if the active form does not match the active query, a run 
options display is shown. This display prompts you to specify options such as, the report form you 
want to use to format the query data, and the mode in which you want to run the query (batch or 
interactive). Run query options are described in detail on page ; 


F6 Run sample. Produces a sample report using the active query and active form. The quer 
retrieves the sample number of rows specified in your Query Manager profile (see page . If 
“Display run options” is set to YES in your Query Manager profile, or if the active form does not 
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F6 


F9 


F10 


F11 


F12 


F13 


F13 


F14 


F15 


F16 


F17 


24 


match the active query, a run options display is shown. This display prompts you to specify the 
report form you want to use to format the query data. (See page for a full description of the 
available run options.) Sample reports are always run in interactive mode and the output is sent to 
display. You cannot use this function key if “Allow interactive sample run” is set to NO in your 
Query Manager profile (see page BQ). 


Insert line. Inserts a line in the current definition or display immediately below the line on which 
the cursor is positioned. To insert a line at the beginning of the definition or display, position the 
cursor immediately above the first line before you press F6. 


Retrieve. Retrieves and displays the last command or statement that was entered in the current 
entry mode (either Query Manager statement or system command). Press F9 once to retrieve the 
last command entered, press F9 twice to retrieve the second-to-last command entered, and so on. 


Copy line. Copies a line in the current definition or display. Place the cursor on the line you want 
to copy and press F10. Then, move the cursor to the position after which you want the line copied 
and press F10 a second time to perform the copy. As with F6, if you want to copy a line to the 
beginning of the definition or display, position the cursor immediately above the first line before 
you press F10 the second time. 


Display description/Display name only. (where name can be query, form, table, or profile). 

Press F11 to hide or display the descriptions of the objects listed on a “Work with” display. When 
you choose to display name only, multiple columns of object names are shown across the “Work 
with” display. The title for this key changes depending on what information is currently displayed. 


Display connection status Press F11 to obtain the detailed connection status for a 
DISCONNECT, SET CONNECTION, or RELEASE statement. 


Cancel. Exits from the current display or option, and returns to the previous display. Any 
information you have added or changed on the current display is discarded. 


Edit query/Edit form. If you are creating or changing an SQL query, F13 (Edit form) takes you to 
the Select Report Format display for the active form. If you are creating or changing a report form, 
F13 (Edit query) takes you to the query editor display for the active query. If there is no active 
form or active query, you are prompted to specify the name of the report form or query that you 
want to edit. You can enter the name of an existing report form or query to edit, or you can enter a 
new name to create a new report form or query. Queries are edited in the mode in which they 
were last saved. Queries are created in your default query creation mode (either promptedor 
SQL). 


Display query/Display form. If you are displaying an SQL query, F13 (Display form) prompts you 
to enter the name of the report form you want to view. If you are displaying a report form, 

F13 (Display query) prompts you to enter the name of the query you want to view. Type the name 
of an existing report form or query; then press the Enter key to show the report form or query 
definition in display-only format. 


Delete line. Deletes the line where the cursor is currently positioned from the current definition or 
display. 


Split line. Breaks a column/file/table name into two lines to allow for insertion of new characters. 
The line will be split at the point where the cursor is located. All characters, from the cursor 
location through the end of the line, will be moved to the new line. 


Repeat position to. Shows the list of object names (on a “Work with” display) beginning at the 
name specified the last time you used F17 (Position to). If you have not used F17 yet, you go to 
the “Position to” window, and Query Manager prompts you to specify the object name at which you 
want the list to begin. 


Position to. Shows you a different portion of the list_of object names (on a “Work with” display). 
For more information, see [The Manager 
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F18 


F19 


F20 


F21 


F21 


F22 


F24 


Display SQL. Displays the SQL statement that you are building in prompted query. For more 
information, see step 


Display column/system column names. Allows you to toggle back and forth between displaying 
either the system column names or the column names while working with a prompted query. For 
more information, see steps through 


Display entire name. Shows the entire name of a column, file, or table when that name is too 
long to fit on the field. If only part of the name is visible, a > character appears at the end of the 
truncated name on the window. 


Select all. Selects all items from the currently displayed list. Usually places a 1 in the Opt prompt 
for all items. 


QM statement/System command. Users with an ALLaccess level can use this key to alternate 
between the two entry modes available through the Query Manager command window. For more 
information, see J 


QM statement. Displays the Query Manager command window for users with an ALL access 
level. You can type Query Manager statements and system commands directly through this 
window. Move the cursor to the window, and press F4 (Prompt) for information about the 
statements and commands you can enter through Query Manager. For more information, see 


More keys. Displays additional function key definitions that apply to the current display. 


The “Position to” window in Query Manager 
When the list of object names for a “Work with” display is more than one display in length, you can view 


additional object names by: 
¢ Using your display station’s roll keys 


¢ Pressing F11 (Display name only) to hide object descriptions and display multiple columns of object 
names 


¢ Using the “Position to” window to begin the list of object names from a new starting point 


You display the “Position to” window by pressing F17 (Position to). An example of the “Position to” window 
is shown in : 
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Work with Query Manager Tables 


Position the List 


POSitHOnr tO: aioe, va ee Starting characters 


F6=Retrieve previous  F12=Cancel Fl6=Repeat position to 


__ ORG Corp.'s organization information 
—— PAYROLL Employee payroll information 
__ PERSONNEL Personnel Information 
— STAFF The STAFF Table 
___— STAFF2 Copy of the STAFF Table 
__ TRAINING Details of Employee training 
___-VENDINFO Vendor Information 
More... 
F3=Exit F4=Prompt F5=Refresh Fll=Display table only  F12=Cancel 


Sia position to F17=Position to F24=More Keys 


Figure 8. The “Position to” Window 


When you press F17 (Position to), Query Manager displays a window that prompts you to specify the 
characters (name) at which you want the “Work with” list to begin. Type the characters and press the Enter 
key. 


The list of object names is displayed starting with the first name found that begins with the characters you 
specified. If no object names are found, Query Managerbegins the list with the last object name that 
comes before the characters you specified. For example, if you specify “G” and no object names begin 
with the letter G, Query Manager begins the list with the last object name that begins with the letter F (so 
you can see that no objects begin with G). 


Query Manager provides special function keys that help you use the “Position to” window: 


F6 Retrieve previous. Displays the last characters that you specified through the “Position to” 
window. Use F6 to view or edit your previous “Position to” characters. 


F16 Repeat position to. Displays the list of object names using the same “Position to” characters you 
specified the last time you used F17 (Position to). If you have not used F17 yet, Query Manager 
displays the error message, “No previous position specified.” 


The "Display entire name” window in Query Manager 

When the name of a file, column, or table is longer than space allows on a particular display, you can view 
its full name by pressing F20 (Display entire name). (Long names are indicated by a “>” character at the 
end of the name.) F20 brings up a window which allows you to view or change the entire table/file/column 
name. The name can be up to 128 characters long not including quotes. The maximum length of the name 
including quotes is 258. 


The name can always be displayed, but can only be changed on some panels. To change a name, 
1. Do one of the following. 
a. Place the cursor on the name 
b. Place the cursor on the line containing the name if there is only one name. 
2. Press F20. 
3. Enter the new name. 
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F20 will also function in the same way in situations where you are entering a file, column, or table name. 
In these situations, Query Managerdisplays the “Display entire name” window with a field large enough to 
contain the entire name. 


Messages and errors in Query Manager 
While using Query Manager, you often see messages at the bottom of the display. Many of these are 
information messages, in which Query Manager tells you what it is doing or has just done. For example: 
STRQM in progress. Starting DB2 UDB for iSeries Query Manager... 
Report form successfully sent for printing. 
Row added. 


You do not need to take any action when you see these messages. They are simply letting you know what 
the system is doing. 


Other messages tell you what you can or should enter on the current display, and how to complete options 
you are performing. For example: 


You can update only your own profile. 
Reposition cursor and press F10 again to complete copy. 
Press Enter to save the copied table and copy the data. 


These messages tell you how to use the current display. Make sure you read them before using the 
display. An example of one of these messages is shown in 


Change Query Manager Profile 


User iproiiille:: et.) een eyes cen eee ee  RREDNURK 
Description ......4.4. +... .. :  \User Profile for Fred Nurk. 


Type choices, press Enter. 
Default library for QM objects .... *CURLIB Name, *CURLIB 
Default object creation authority .. *LIBCRTAUT *CHANGE, *ALL, *USE 
*EXCLUDE, *LIBCRTAUT 
Authorization list 


Run query mode: 2 2. se ee eee 1 1=Interactive 
2=Batch 
Number of rows to use for sample... 50 1-100 
Display run options « .. + « *% « « if Y=Yes, N=No 
Confirmation messages in QM ..... y Y=Yes, N=No 
Namingconvention 205 sess ee a) a *SYS *SYS, *SAA 
RDB Connection method . «4 « » « «= « *RUW *RUW, *DUW 
Default library for QM tables .... *CURLIB_ Name, *NONE, *CURLIB 
3=Table 
More... 
F3=Exit F4=Prompt F5=Refresh F10=Display additional details 


F12=Cancel F22=QM statement 
You can update only your own profile. 


Figure 9. Example of a Message on a Display 


Some messages are warning messages. They warn you that what you are about to do might not work, or 
might cause damage to programs, devices, systems, or data. For example: 


Active query will be lost if you run this new query. 
Warning. CCSID conversion resulted in substitutions. 
Date/Time formats of job and query are different. 
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Read these messages, and make sure you understand them before continuing with your option. 


The last type of Query Manager messages are error messages. These messages are displayed when you 
make an entry error of some kind. Query Manager shows you where the error is whenever possible, by 
moving the cursor to the value in error and highlighting it in reverse video. You also see a message at the 
bottom of the display telling you what the error is and how to correct it. For example: 


Library must be blank if Table for Output is «NONE. 
Cannot create a blank table definition. 
Active data is sample only. Cannot display a full report. 


These are important messages. In most cases, reading the message tells you how to correct the error you 
made. You need to make the correction before you can continue with your current option. 


If you need additional information about any of the messages you see displayed, move the cursor to the 
line that contains the message; then press F1 (Help). The message help display and job log are described 


Only one message can be shown at the bottom of the display at one time. If Query Manager has issued 
more than one message, you see a “+” sign at the end of the displayed message. You can use your 
display station’s roll keys to see the additional messages. 


Using the command window in Query Manager 


Query Manager provides a command window through which users with an ALL access level can enter 
Query Manager statements and system commands. The command window is available by pressing 
F22 (QM statement) from most displays. Figure 1d shows an example of the command window. 


(a > 
DB2 Query Manager 0S/400 
System: | ABC400A 


Select one of the following: 
1. Work with Query Manager queries 
2. Work with Query Manager report forms 


3. Work with Query Manager tables 


10. Work with Query Manager profiles 


Query Manager Statement 


QM... 


F4=Prompt F9=Retrieve  F12=Cancel F21=System command 


F3=Exit F12=Cancel F22=QM statement 


Figure 10. The Command Window 


Use this window to enter commands and statements quickly, without leaving the current display. For 
example, if you choose to create a report form, but there is no active data (which means that Query 
Manager has no default values for report formatting), you can enter a RUN QUERY statement through the 
command window to run a query and create active data for the report form. 


28 DB2 UDB for iSeries Query Manager Use V5R2 


Query Manager provides special function keys that help you use the command window: 


F4 


F9 


F2 


1 


Prompt. Displays a list of all of the Query Manager statements or system commands that you can 
enter through the command window. If you are unsure of the syntax of a statement or command, 
follow the instructions on these prompt-guided displays, and let Query Manager enter the 
statement or command for you. 


Retrieve. Retrieves and displays the last command or statement that was entered through the 
current mode (either Query Manager statement or system command). Press F9 once to retrieve 
the last command entered, press F9 twice to retrieve the second-to-last command entered, and so 
on. 


System command/QM statement. Alternates between the two entry modes, system command 
and Query Manager statement. When you are in Query Manager statement mode, the window 
prompts you to enter a Query Manager statement, and the command prompt is shown as QM... 
When you are in system command mode, the window prompts you to enter a system command, 
and the command prompt is shown as ===>. 


Note: The Query Manager statement line is always present at the top of the Edit Query or Display Query 


displays, so there is no F22 (QM statement) function key available from these displays. You can 
press F21 (System command) to display a command window through which you can enter only 
system commands. 


When you finish using the command window, press F12 (Cancel) to leave the window and return to the 
display you were using when you pressed F22 (QM statement). 


Naming conventions in Query Manager 


For any undelimited name, DB2 UDB for iSeries Query Manager always converts lower case characters to 
upper case characters. Objects of the same type stored in the same library must have unique names. 
However, since report forms and queries are two different object types you can have a query by the name 
of TEST and a report form by the name of TEST in the same library. Since procedures, tables, and views 
are all OS/400 files, you cannot have a procedure and a table with the same name. The rest of this 
section describes the different naming conventions for tables, columns, queries and report forms. 


Note: It is recommended that the name not start with the letter q. 


Form and query name conventions in Query Manager 
Form and query names can be specified as undelimited names or delimited names. 


Undelimited names, names that do not contain quotation marks, are specified as follows: 
Names need to begin with an alphabetic character. Alphabetic characters are A-Z, $, # and @. 


The alphabetic character may be followed by other alphabetic characters, the numbers 0-9, and 
underscores. 


No imbedded blanks are allowed in the name. 
Names can be up to 10 characters in length. 


Delimited names, names that do contain quotation marks, are specified as follows: 
The name begins and ends with a double quotation mark ("). 
The only characters not allowed inside the beginning and ending quotes are: 


A blank 

An asterisk (*) 

A question mark (?) 
An apostrophe (’) 
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— Quotation marks (") 
— Numbers with a hexadecimal value less than ’40’X or equal to ’FF’X. 
Names can be up to 10 characters in length including the beginning and ending double quotes. 


Note: A quoted name can be qualified, but the object name and library name need to be surrounded by 


quotation marks separately from each other. For example, "MYLIB" "Name-1" 


Table and file name conventions in Query Manager 
Table or File names can be specified as undelimited names or delimited names. 


Undelimited names, names that do not contain quotation marks, are specified as follows: 


Names need to begin with an alphabetic character. Alphabetic characters are A-Z, $, # and @. 


The alphabetic character may be followed by other alphabetic characters, the numbers 0-9, and 
underscores. 


No imbedded blanks are allowed in the name. 
Names can be up to 128 characters in length. 


Delimited names, names that do contain quotation marks, are specified as follows: 


The name begins and ends with a double quotation mark ("). 


The only characters not allowed inside the beginning and ending quotes are characters with a 
hexadecimal value less than ’40’X or equal to ’FF’X. 


Double quotation marks that are included within the name must be accompanied by a matching double 
quotation mark. 


Names can be up to 128 characters in length not including the beginning and ending double quotes and 
any matching double quotes within the name. 


Column name, field name, and expression name conventions in Query 
Manager 
Undelimited names, names that do not contain quotation marks, are specified as follows: 


Names need to begin with an alphabetic character. Alphabetic characters are A-Z, $, # and @. 


The alphabetic character may be followed by other alphabetic characters, the numbers 0-9, and 
underscores. 


No imbedded blanks are allowed in the name. 
Names can be up to 30 characters in length. 


Delimited names, names that do contain quotation marks, are specified as follows: 


The name begins and ends with a double quotation mark ("). 


The only characters not allowed inside the beginning and ending quotes are characters with a 
hexadecimal value less than ’40’X or equal to ’FF’X. 


Double quotation marks that are included within the name must be accompanied by a matching double 
quotation mark. 


Names can be up to 30 characters in length including the beginning and ending double quotes and any 
matching double quotes within the name. 


Understanding the overflow character (>) in Query Manager 


When a file, table, column or field name exceeds the number of characters that can be shown on a 
particular display, DB2 UDB for iSeries Query Manager shows the overflow character, ">" following the 
name. When the cursor is positioned on a name followed by an overflow character, and the F20=Display 
entire name key is pressed, DB2 UDB for iSeries Query Manager displays a window showing the name in 
its entirety. 
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If you replace the last character of the name with a blank, the remaining unseen characters following that 
blank will be replaced with blanks. 


Suppose the table name in the Create Query Manager Table display shows the table name as follows: 
Table. ..... THIS IS A LONG TAB > 


If you pressed F20, the name in the display would look like: 
Table...... THIS_IS_A_LONG TABLE _NAME 


If you then blanked out the last 4 characters (’_TAB’) in the shortened name shown in the Create Query 
Manager Table display and then pressed F20, the name would display as follows: 


Tablea-e ae Bo THIS_IS_A_LONG 
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Chapter 3. Working with Query Manager profiles 


This chapter tells you about the Query Manager profile. Much of the information you can access and 
process within Query Manager is determined by the values of the settings in your profile. 


This chapter describes the Query Manager profile in detail, and explains the settings within your profile 
that you can change. It also includes instructions for security administrators, describing the different user 
access levels available within Query Manager, and explaining how to maintain profiles for different types of 
users. 


What is a Query Manager profile? 


A profile is a description of a user. A Query Manager profile is the section of your iSeries user profile that 
controls the options you can select, and the default values used when you run Query Manager. Your 
Query Manager profile is created the first time you start to use Query Manager. Profiles can also be 
created by security administrators for users who should run Query Manager using settings other than 
those contained in the default profile. You can change and maintain your own Query Manager profile by 
selecting option 10 (Work with Query Manager Profiles) from the main menu. 


Your Query Manager profile contains information and settings such as: 

* The mode in which you want to run queries 

¢ The number of data rows you want sample queries to retrieve 

* The output destination to which you want to send reports 

¢ The default library in which you want to store queries and report forms 


Security administrator user access level in Query Manager 


Query Manager is intended to be used by a wide range of users for a wide range of applications, therefore 
there needs to be a way of controlling who has access to which options. Each Query Manager installation 
should have at least one user called the security administrator. This administrator is responsible for 
maintaining Query Manager profiles by specifying, for each user, the access level and default settings 
Query Manager should use when it is running. Many of these settings can later be changed by users when 
they are running Query Manager. 


Security administrator authority ("SECADM) is assigned outside of, and is not controlled by, Query 
Manager. There are two user access levels available within Query Manager: ALL and BASIC. 


Security administrators are responsible for maintaining the Query Manager profiles for Query 
Managerusers. They can display the profiles of users for whom they have *READ rights, and can change 
the access levels and default values in the profiles of users for whom they have *OBJMGMMT rights. 
Security administrators need to have an ALL access level in their own Query Manager profiles. For 
information on *SECADM authority and *OBJMGMT rights, see iSeries Security Reference. 


When the security administrator selects option 10 to see the Work with Query Manager Profiles display. 
The following screen is displayed: 
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Va 


Work with Query Manager Profiles 


Type options, press Enter. 
2=Change 3=Copy 5=Display 


User 
Opt Profile Description 


FREDNURK User profile for Fred Nurk. 
JOESMITH User profile for Joe Smith. 
JONESD David Jones - Accounts. 
LIZARD Night-shift Operator. 
QSECOFR System Administrator. 


F3=Exit F5=Refresh F1l=Display profile only F12=Cancel 
F16=Repeat position to F17=Position to F22=QM Statement 


Ke 


More... 


Figure 11. Security Administrator User Access Level 


ALL user access level in Query Manager 


ALL access grants full access to the Queries, Report Forms, and Tables options. Users can change most 
of the values in their own Query Manager profiles, but they cannot access any other user’s profile. The 
ALL access level is the default, and is suitable for users who want to create, change, and run queries and 
report forms. Knowledge of the DB2 UDB for iSeries SQL language and report generation is beneficial. 


When someone with a user access level of ALL selects option 10 to see the Work with Query Manager 


Profiles display. The following screen is displayed: 
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Change Query Manager Profile 


User profile: <<. 2-i wis Sw ee we P FREDNURK 
Description .......4. 5... . : (User Profile for Fred Nurk. 


Type choices, press Enter. 
Default library for QM objects .... *CURLIB Name, *CURLIB 
Default object creation authority .. *LIBCRTAUT *CHANGE, *ALL, *USE 
*EXCLUDE, *LIBCRTAUT 
Authorization list 


Runsquery modes s.5. tw ee tee es eas 1 l=Interactive 
2=Batch 
Number of rows to use for sample... 50_ 1-100 
Display uni options. ¢ — 36% a 2s Y Y=Yes, N=No 
Confirmation messages in QM ..... Y Y=Yes, N=No 
Naming.conventiion® 2 313 See Boe se *SYS *SYS, *SAA 
RDB Connection method ........ *RUW *RUW, *DUW 
Default library for QM tables .... *CURLIB_ Name, *NONE, *CURLIB 
3=Table 
More... 
F3=Exit F4=Prompt F5=Refresh F10=Display additional details 
F12=Cancel F22=QM statement 
You can update only your own profile. y, 


Figure 12. ALL User Access Level 


BASIC user access level in Query Manager 


BASIC access grants full access to the Tables option, and restricted access to the Queries and Report 
Forms options. Users can display, print, and run queries and report forms, but cannot create or change 
them. Most of the values users can change in their Query Manager profiles control the way in which 
queries and reports are run. They cannot access any other user’s profile. The BASIC access level is 
suitable for users who want to run queries and reports, and create and use tables. Knowledge of the DB2 
UDB for iSeries SQL language, databases, and report generation is helpful but not necessary. 


When someone with a user access level of Basic selects option 10 to see the Work with Query Manager 
Profiles display. The following screen is displayed: 
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Change Query Manager Profile 


FREDNURK 
User Profile for Fred Nurk. 


Wser protile: = «24 6 «3.8 494 Sa oF 
Description 


Type choices, press Enter. 


Runiquery mode: <. 2.3. 6) ss a ee es Sn Hf 1=Interactive 
2=Batch 
Number of rows to use for sample... 50_ 1-100 
Display cuni-Opeions: ya soe. 5 es ce, es Y Y=Yes, N=No 
Query data outputs hives cs et nes eens 1 1=Display, 2=Printer 
3=File 
Printer to use for output ...... *JOB Name, *JOB 
F4 for list 
File tov use for output vs. 2. ea a oe *NONE Name, *NONE 
F4 for list 
Default query creation mode ..... 2 1=SQL, 2=Prompted 
Bottom 
F3=Exit F4=Prompt F5=Refresh F10=Display additional details 
F12=Cancel 
You can update only your own profile. ) 


Figure 13. Change Query Manager Profile Display for BASIC user 


The default query manager profile in Query Manager 


A default Query Manager profile is created automatically the first time you start to use Query Manager. 

shows the initial access levels and settings for the default profile. These levels and settings are 
described in detail over the following pages. In the “Who Can Change?” column, SA is used to indicate the 
security administrator. 


Table 3. Default Query Manager Profile Values 


Who Can 
Profile Attribute Default Value Possible Values Change? 
Default library for QM objects *CURLIB Name, *CURLIB All, SA 


Default object creation authority *LIBCRTAUT *CHANGE, *ALL, *USE, *EXCLUDE, |All, SA 
*LIBCRTAUT, Authorization list 

Run query mode * Interactive 1=Interactive, 2=Batch Basic, All, SA 

Allow change run query mode Yes Y=Yes, N=No SA? 

User access level All 1=All, 2=Basic SA 

Number of rows to use for sample 50 1 to 100 Basic, All, SA 

Allow interactive sample run Yes Y=Yes, N=No SA 

Maximum number of rows allowed *NOMAX 1 to *NOMAX SA 

on interactive run 

Display run options Yes Y=Yes, N=No Basic, All, SA 

Confirmation messages in QM Yes Y=Yes, N=No All, SA 

Naming convention *SYS *SYS, *“SAA All, SA 

Relational database connection *NONE Name, *NONE, *CURRENT SA 

RDB connection method *RUW *“RUW, *DUW All, SA 

Default collection for QM tables *NONE Name, *NONE, *CURLIB All, SA 

Query data output Display 1=Display, 2=Printer, 3=Table Basic, All, SA 
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Table 3. Default Query Manager Profile Values (continued) 


Who Can 
Profile Attribute Default Value Possible Values Change? 
Printer to use for output *JOB Name, *JOB Basic, All, SA 
Table to use for output *NONE Name, *NONE Basic, All, SA 
Collection (for output table) Name, *LIBL, *CURLIB Basic, All, SA 
Job description for batch run *USRPRF Name, *USRPRF All, SA 
Library (for job description) Name, *LIBL, *CURLIB All, SA 
Commitment control level None 1=None, 2=Change, All, SA 
3=Cursor stability, 4=All, 
5=Repeatable read 
Default query creation mode’ Prompted? 1=SQL, 2=Prompted BASIC, All, SA 
Allow change query creation mode ‘| Yes Y=Yes, N=No SA? 
Show query sort sequence options No Y=Yes, N=No All, SA 
Allow access to QM tables Yes Y=Yes, N=No SA 
Default column names displayed Column names 1=Column names, 2=System column | All, SA 
names 
Select allowed SQL statements N/A Y=Yes, N=No SA? 
Notes: 
i You cannot change your “Run query mode?” if “Allow change run query mode” is set to NO. You cannot 
change your “Default query creation mode?” if “Allow change query creation mode” is set to NO. 
= The “Default query creation mode” is prompted for new Query Manager users, and SQL for users who are 
upgrading from V2R1.1. 
3 These attributes can only be seen by the security administrator. Users with BASIC and ALL do not see 


these attributes. 


Security administrator tasks are described in detail beginning on page lal 


Default library for Query Manager objects 


Allows you to specify the library in which you want Query Manager to store the query and report form 


objects you create. 


Name 


enter a library name. 


Specify a library name to be used as the default whenever Query Manager prompts you to 


If you type the name of a library that does not exist, Query Manager shows a prompt 
window asking if you want to create the library in either batch or interactive mode. 


*CURLIB 


Specify the library in your current job on the iSeries system as the library to be used as 


the default whenever Query Manager prompts you to enter a library name. 


The default is *CURLIB. This setting can be changed by users with an ALL access level. 


Default object creation authority in Query Manager 


This value sets the default security level for all query and report form objects you create. 


*CHANGE 


Allows other users to read and work with your objects, but does not allow other users to 


delete, replace, or transfer ownership of your objects. When other users change an object, 
they must specify a new name for the object. 


*ALL 
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Allows other users to perform all operations on your objects except transferring ownership. 
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*USE Allows other users to read, run, export, and print your objects, but does not allow others to 
change, replace, or import your objects. 


*EXCLUDE Prevents other users from doing anything to your objects unless you specifically grant 
them authority (for example, through an authorization list). 


*LIBCRTAUT Takes the authority for your objects from the library in which they are created. If the library 
authority changes, the new authority does not affect the authority of existing objects. 


Authorization list 
This is a list through which you can assign security authorities for your objects to individual 
users. Full instructions on how to use an authorization list can be found in iSeries Security 
Reference. 


The default is *LIBCRTAUT. This setting can be changed by users with an ALL access level. 


Run query mode in Query Manager 
This allows you to specify the mode in which you want to run queries and reports: either interactive or 
batch. 


Interactive This mode causes queries and reports to run as soon as you issue a RUN statement. Use 
this mode when you want to create active data, and view the results of RUN statements 
on your display screen. Be aware, though, that interactive mode might tie your display 
station up for extended periods while you wait for large jobs to finish running. 


Batch This mode causes queries and reports to be submitted to a batch queue when you issue a 
RUN statement. The order in which the jobs in the batch queue are run depends on what 
each job’s priority levels are, and how many other jobs there are in the queue. Your job 
might be run immediately, or you might have to wait for jobs with higher priority levels to 
finish running before your job begins. This mode frees your display station immediately 
after you issue a RUN statement, but it does not create active data, and you cannot send 
query output to display. 


The default mode is interactive. This setting can be changed by users with BAS/C and ALL access levels, 
although not all users see this prompt in their profiles. The security administrator can set “Allow change 
run query mode” to YES or NO. If you are not able to change your run query mode, this prompt is not 
shown in your Change Query Manager Profile display, and you cannot change the mode when you run 
queries and reports. Press F10 (Display additional details) to view your run query mode. 


Allow change run query mode in Query Manager 
This value determines whether you can work in run query mode. 


Yes Allows you to change the “Run query mode” setting in your Query Manager profile, and to change 
the mode setting when you run queries and reports. 


No Forces you to run all jobs in the mode specified in your profile (either batch or interactive) and 
removes the “Run query mode” prompt from your Change Query Manager Profile display. 


The default authority is Yes. This setting can be changed only by a security administrator. 


User access level in Query Manager 
This value assigns a user access level of either ALL or BASIC. All security administrators need to have an 
ALL access level in their Query Manager profiles. 


ALL This level grants full access to the Queries, Report Forms, and Tables options. Users can change 
most of the information in their own Query Manager profiles. 


BASIC 
This level grants full access to the Tables option, and restricted access to the Queries and Report 
Forms options. Users can display and print query and report form definitions, and run queries and 
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reports, but they cannot create or change queries or report forms. Most of the information users 
can change in their Query Manager profiles determines the way in which queries and reports are 
run. 


The default access level is ALL. This setting can be changed only by a security administrator. 


Number of rows to use for sample in Query Manager 

This allows you to specify the maximum number of rows you want retrieved by a query when it is run 
using the sample restriction. (Sample queries are described on page a) Type any number from 1 to 100. 
The default is 50. This setting can be changed by users with BASIC and ALL access levels. 


Allow interactive sample run in Query Manager 
This setting is used by the security administrator to specify whether you can run queries and reports using 
the sample restriction. 


Yes Allows you to run queries and reports using the sample restriction. 


No Keeps you from being able to run sample queries and reports. 


If your “Run query mode” is batch and you cannot change it, a value of NO stops you from being able to 
run queries interactively to create active data. (Sample queries and reports are always run in interactive 
mode.) 


The default authority is YES. This setting can be changed only by a security administrator. 


Maximum number of rows allowed on interactive run in Query Manager 

Specifies the maximum number of rows retrieved when you run queries in interactive mode. Type a value 
between 1 and *NOMAX, where *NOMAX indicates that there is no limit to the number of rows retrieved. 
This value is ignored when you run queries in batch mode. 


If Query Manager retrieves the maximum number of rows before it completes a query, you see a message 
at the bottom of the display informing you that “Maximum number of records reached. Data is 
incomplete.” When this happens, final summary functions such as SUM, AVERAGE, and COUNT are 
omitted from reports. 


The default maximum is *“NOMAX. This setting can be changed only by a security administrator. 


Display run options in Query Manager 

Specifies whether you want the program to prompt you for run options whenever you press a function key 
to run an SQL query, a prompted query, or a report. Run options are always displayed when you run 
queries and reports using Work with displays. 

Yes Displays the Run Query display, which prompts you to enter the following information: 


* The mode in which to run the query: either batch or interactive. (This prompt is not displayed if 
your “Allow change run query mode” is set to NO.) 


Note: If you are running a non-SELECT SQL query, you are only prompted for the mode. 


¢ Whether to run the query using the sample restriction. (This prompt is not displayed if your 
“Allow interactive sample run” is set to NO.) 

¢ The report form to use to format the query data and the library in which it resides (if you are 
running a query). 


* The query to run and the library in which it resides (if you are running a report). If active data 
exists, you can specify to use the active data instead of running a query. 


¢ The output destination: either display, printer, or table. 
¢ The name of the printer or OS/400 output queue (if output destination is printer). 
* The names of the table and collection (if output destination is table). 
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No Suppresses the Run Options display and uses the default settings from your Query Manager 
profile. 


The default value is YES. This setting can be changed by users with BASIC and ALL access levels. 


Confirmation messages in Query Manager 
Allows you to specify whether or not to display confirmation messages. You can override this value by 
specifying “CONFIRM=Y” or “CONFIRM=N” when you enter a Query Manager statement. 


Yes Display confirmation messages when you delete or replace objects by entering Query Manager 
statements through the command window. Confirmation messages are always displayed when you 
delete or replace objects through Query Manager displays. 


NO Suppresses the confirmation messages. 
The default value is YES. This setting can be changed by users with an ALL access level. 


Naming convention in Query Manager 
Allows you to specify whether you want to use *SYS or *SAA naming conventions. 


*SYS_ Causes most displays to prompt for files and libraries rather than tables and collections. Query 
Manager expects you to use SYSTEM conventions when you create and name queries and report 
forms, and when you enter commands and statements through the command window. For 
example: 


SELECT FLD1, FLD2 FROM TESTDATA/PHONE 
RUN QUERY TESTDATA/QUERY 


If no library name is specified in a command or statement, Query Managersearches the library 
named as the “Default library for QM objects” in your Query Manager profile to find the object. If 
no library name is specified in a query, Query Manager searches the library list (*L/BL) to find the 
object named in the SQL statement. 


*SAA Causes most displays to prompt for tables and collections rather than files and libraries. Query 
Manager expects you to use SQL conventions when you create and name queries and report 
forms, and when you enter commands and statements through the command window. For 
example: 


SELECT FLD1, FLD2 FROM TESTDATA. PHONE 
RUN QUERY TESTDATA. QUERY 


If no library name is specified in a command or statement, Query Managersearches the library 
named as the “Default library for QM objects” in your Query Manager profile to find the object. If 
no library name is specified in a query, Query Manager searches the library or collection with the 
same name as your user ID to find the object named in the SQL statement. 


Note: If you specify “SYS naming conventions, the only relational databases you can CONNECT to are 
those on a local machine or those on another iSeries system. 


The default naming convention is *SYS. This setting can be changed by users with an ALL access level. 


Relational database connection in Query Manager 
This allows you to specify the name of the relational database to use when the user starts Query Manager 


Name Specify a name for a relational database to connect to each time the user starts Query 
Manager 


If the user has specified “SYS naming conventions, the only relational databases you can 
enter here are those on a local machine, or those on another iSeries system. 


*CURRENT Specifies that the database connection which exists when the user starts Query Manager 
should continue to be used. 
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*NONE Specifies that no remote connection is made, and if necessary, you are connected to your 
local database when Query Manager is started. 


The default database connection is “NONE. This setting can be changed only by a security administrator. 


After the setting is changed, the new relational database connection does not come into effect until the 
next time the user starts Query Manager. Users who want to connect to the new relational database 
immediately should enter the CONNECT statement on the Query Manager statement line (see page 
for instructions). 


RDB connection method in Query Manager 
This specifies the connection method to use. 


*DUW Specifies that multiple database connections can be entered. 


*RUW Allows you to select a connection to a single database. 


For more information on when to use *RUW and *DUW, see Figure 101 on page 183) 


The default in Query Manager is *RUW. This setting can be changed by users with an ALL access level. 


Default collection for tables in Query Manager 

This specifies the name of the collection or library in which to store your Query Manager tables. You need 
to have *CHANGE authority for the collection or library if you want to use all options available through the 
Work with Query Manager Tables display. 


Name_ Specify the collection or library in which you want to store your Query Manager tables. 


If you specify a name, Query Manager selects that collection when you choose to Work with 
Query Manager Tables. If the name you enter does not exist, Query Manager shows a prompt 
window asking if you want to create a new collection in either batch or interactive mode. If you 
choose to create the collection and you answer YES to the prompt asking if you want an “SQL 
catalog as part of the library”, Query Manager creates a collection; otherwise it creates a 
library. 


*NONE 
Specify this if you want Query Manager to prompt you to specify a collection name each time you 
choose to Work with Query Manager Tables. 


*CURLIB 
Specify the collection or library in your current job on the iSeries system as the one in which to 
store your Query Manager tables. 


The default is *NONE. This setting can be changed by users with an ALL access level, although not all 
users see this prompt in their profiles. The security administrator can set “Allow access to QM tables 
option” to YES or NO. If you are not able to use the QM tables option, you do not need to specify a 
default collection, so the “Default collection for QM tables” prompt is not shown on the Change Query 
Manager Profile display. 


Note: Security administrators need to specify a collection name for users who have a BASIC access level. 
BASIC access users cannot have a default collection of *NONE. 


Query data output in Query Manager 
Specifies the default output destination to use when you run queries and reports. 


Display Specify to send output data to the display. 


Note: You cannot send the output to display if your “Run query mode” is set to batch. 


Printer Specify to send output data to the printer. 
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Printer Specify to write output data to a table. 


The default is display. This setting can be changed by users with BASIC and ALL access levels. 


Printer to use for output in Query Manager 
This specifies the default printer you want to use for query and report output. 


Name _ Specify a printer on which to print queries and reports. You can press F4 (Prompt) for a list of all 
available printers from which you can make a selection. 


*JOB Specifies to use the printer specified in your current job on the iSeries system. 
The default is *JOB This setting can be changed by users with BASIC and ALL access levels. 


Table to use for output in Query Manager 
This specifies the default table you want to use for query and report output. 


Name _ Specify a table to use for query and report output. You can press F4 (Prompt) for a list of all 
tables in the specified collection from which you can make a selection. 


*NONE 
Specifies that you want to be prompted for a table name each time you run a query or report. 
Notes: 
1. You cannot specify a table name of *NONE if “Display run options” is set to NO and “Query data 
output” is set to table. 
2. If you are connected to a remote database, the table and collection you specify are saved on the local 
iSeries system. 


The default is “NONE. This setting can be changed by users with BASIC and ALL access levels. 
Collection (for Output Table) 

This is the name of the collection or library in which the default output table resides, or to which you want 
the default output table written. Leave the name blank if you specified an output table of “NONE or you 


entered a valid object name for your output table. If you specified a name Query Manager inserts the 
library you specified as the “Default library for QM objects”. 


Name Specify an existing collection or library name in which the table exists. 

*LIBL Specify the library list is to be searched for the collection or library in which the table 
exists. 

*CURLIB Specify that Query Manager is to use the library in your current job on the iSeries system. 


The default is *NONE. This setting can be changed by users with BASIC or ALL access levels. 


Job description for batch run in Query Manager 
This specifies the job description you want to use when running queries and reports in batch mode. A job 
description contains information such as: 


¢ Which batch queue to use 

¢ What your job’s priority levels are 
¢ Which output queue to use 

¢ Which printer to use 


Name Specify the name of the job description you want to use when running queries and reports 
in batch mode. 


Press F4 (Prompt) for a list of all job descriptions in the specified library from which you 
can make a selection. 
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*USRPRF Specify your regular job description. 

The default is *USRPRF. This setting can be changed by users with an ALL access level. 

Library (for Job Description) 

This is the name of the library in which your job description resides. Leave the library name blank if you 


specified a job description of *USRPAF or you entered a valid name for your job description. If you 
specified a name Query Manager inserts the library you specified as the “Default library for QM objects”. 


Name Specify an existing library name. 

*LIBL Specify that the library list is to be searched for the library that contains the job 
description. 

*CURLIB Specify for Query Manager to select the library in your current job on the iSeries system. 


There is no default. This setting can be changed by users with an ALL access level. 


Commitment control level in Query Manager 
This specifies the commitment control lock level under which you want to run Query Manager. 


None No rows are locked. 
Change All rows you change are locked until you issue a COMMIT or ROLLBACK statement. 


Cursor stability 
All rows you change and the row in which the cursor is currently positioned are locked 
until you issue a COMMIT or ROLLBACK statement. 


All All rows you change or view are locked until you issue a COMMIT or ROLLBACK 
statement. 


Repeatable read 
All rows you change or view are locked until your unit of work (UOW) is completed. Any 
row that is read or changed during a unit of work cannot be changed by any process until 
the unit of work is completed. During the unit of work, multiple reads always give the same 
results. 


Note: You must use care when choosing a commitment control level of repeatable read 
because it can result in concurrency problems. The table is locked and is not 
available for change by another user until the COMMIT or ROLLBACK is done. 


The default level is none. This setting can be changed by users with an ALL access level. When you 
change this setting, the new commitment control level does not come into effect until the next time you 
start Query Manager, or the next time you enter the CONNECT statement on the Query Manager 
statement line (see page 248). 


Note: You can override the commitment control level by running a SET TRANSACTION statement in a 
DB2 UDB for iSeries Query. This will not change the commitment control level you have set. For 
more information, see 


Default query creation mode in Query Manager 
This specifies the default mode in which you want to create queries. 


SQL This mode shows the Edit Query display when you choose to create a query. You can 
create queries containing any one of the SQL statements that you were granted authority 
to use (through your profile). If you need help entering an SQL statement, press 
F4 (Prompt) for a list of all supported statements and their syntax. 


Prompted This mode shows the Define Prompted Query displays when you choose to create a 
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query. You can create SELECT statement queries through these displays. The displays 
prompt you to enter all of the information that Query Managerrequires to create the query. 


The default is SQL for users who are upgrading from Query Manager V2R1.1 and prompted for other 
Query Manager users. 


This setting can be changed by users with an ALL access level, although not all users see this prompt on 
their Change Query Manager Profile display. The security administrator can set “Allow change query 
creation mode” to YES or NO. If you are not able to change your query creation mode, this prompt is not 
shown in your Change Query Manager Profile display, and you cannot change the mode when you create 
queries. Press F10 (Display additional details) to view your default query creation mode. 


Allow change query creation mode in Query Manager 
This specifies whether you can change your default query creation mode and whether you can change the 
mode setting when you create queries. 


YES Allows you to change the “Default query creation mode” setting in your Query Manager profile, and 
to change the mode setting when you create queries. 


NO Forces you to create and change all queries in the mode specified in your profile (either SQL or 
prompted), and stops you from being able to change the “Default query creation mode” shown at 
the top of the Change Query Manager Profile display. 


The default is YES. This setting can be changed only by a security administrator. 


Show query sort sequence options in Query Manager 
This determines whether you can specify the sort sequence and language when you create or change a 


query. 
YES __ Allows you to specify the sort sequence and language when creating or changing a query. 


When you display a query that was created with a specified sort sequence, the sort sequence 
information is shown regardless of the setting of this profile option. 


If you choose this option, the Specify sort sequence option is available on the Define Prompted 
Query display and F18 (Sort Sequence) is available on the Edit Query display. 


NO Keeps you from specifying the sort sequence and language when creating a query. It also keeps 
you from changing the sort sequence and language if the query was created with the default 
sequence and language. 


The default is NO. This setting can be changed by users with an ALL access level, 


Allow access to tables option in Query Manager 
This specifies whether you can use the Work with Query Manager Tables display and its options. 


YES Allows you to use the Work with Query Manager Tables display and its options. 


NO Denies access to the Work with Query Manager Tables display, and removes the Work with Query 
Manager tables option from the main menu. 


You can still run queries and produce reports using the data contained in Query Manager tables, 
but you cannot use any of the options listed on the Work with Query Manager Tables display. See 
4) for more information. 


The security administrator can limit the options that users can choose through the Work with Query 
Manager Tables display by changing their authority to use different collections and libraries. See page 
for more information. 


The default authority is YES. This setting can be changed only by a security administrator. 
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System column names displayed in Query Manager 
This specifies whether the column names are shown by default on the Query Manager displays. 


1 Causes the column names to be shown on the Query Manager displays. 


2 Causes the system column names to be shown on the Query Manager displays. 
The default is 1. The value can only be changed by a non-basic user. 


Select allowed SQL statements in Query Manager 
Note that this is a directional aid, not a profile setting. This specifies whether the Select Allowed SQL 
Statements display is shown. 


Through the Select Allowed SQL Statements display, the security administrator specifies the SQL 
statements that you can and cannot use when you create, change, and run Query Manager SQL queries. 


YES Shows the Select Allowed SQL Statements display. Figure 20 on page 54 shows an example of 
this display. 


NO Does not show the Select Allowed SQL Statements display. 


The default is for users who are upgrading from Query Manager V2R1.1 to have authority to use all SQL 
statements, and for new users to have authority to use only the SELECT statement. This setting can be 
changed only by a security administrator. 


Viewing the additional details display in Query Manager 


Most users can press F10 (Display additional details) to view a list of the SQL statements they have 
authority to use. If the “Allowed SQL statements” setting on the Additional Details display is YES, you can 
press the Enter key to view a list of the SQL statements you have authority to use. If the “Allowed SQL 
statements” setting is NO, you do not have authority to use any SQL statements, so pressing the Enter 
key returns you to the Change Query Manager Profile display. 


Granting 
Oro C 


Notes: 


1. These authorities affect only those queries created in the SQL creation mode. You do not need 
authority to use the SELECT statement to create, change, or run a prompted query. 


2. If authority is restricted for all SQL statements, you cannot create, change, or run SQL queries. Your 
“Default query creation mode” needs to be set to prompted, and “Allow change query creation mode” 
needs to be set to NO. 


3. If authority to use the COMMIT and ROLLBACK statements is not granted, you cannot have a 
“Commitment control level” of change, cursor stability, repeatable read, or all. 


4. These authorities and restrictions apply only when you create, change, and run SQL queries. You can 
still copy, rename, and display SQL queries containing all SQL statements. 


Changing your Query Manager Profile 


You view and change the settings and values from your Query Manager profile using the Work with Query 
Manager Profiles option. 

1. Type 10 in the Selection prompt from the Query Manager main menu. 

2. Press the Enter key to show the Change Query Manager Profile display. 


Changing a BASIC access profile in Query Manager 


If you have a BASIC access level, you have full access to the Tables option (unless it has been restricted 
through your Query Manager profile), and limited access to the Queries and Report Forms options. You 
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can run queries and reports, and display and print their definitions, but you cannot create or change query 
or report form definitions. Most of the information you can change in your Query Manager profile controls 
the way in which queries and reports are run. 


1. Type 10 in the Selection prompt from the Query Manager main menu. 
2. Press the Enter key. You see a display similar to the one shown in igure 14) 


te j ~ 
Change Query Manager Profile 
WSerprotiles 2. 6: 2% aie es eels a as es)  RIREDNURK 
Description «+2423 <5 2.4% 2.6 £ User Profile tor Fred: Nurk: 


Type choices, press Enter. 


Rune query modes... ce, vs. ce ce at cee eg 1 1=Interactive 
2=Batch 

Number of rows to use for sample... 50_ 1-100 

Display: TUN OptONsS® si. secs ccc. ap Bs Y Y=Yes, N=No 

Querysdata output.” 294.0. c a ee ee es 1 1=Display, 2=Printer 
3=File 

Printer to-use: for output: . 22:5 2... *JOB Name, *JOB 
F4 for list 

Piles touse: for Output: : .  chi So *NONE. Name, *NONE 
F4 for list 

Default query creation mode ..... 2 1=SQL, 2=Prompted 

Bottom 


F3=Exit F4=Prompt F5=Refresh F10=Display additional details 
F12=Cancel 
You can update only your own profile. 


Figure 14. Change Query Manager Profile Display for a BASIC Access User 


3. Move the cursor to the prompts for the values you want to change, and type the new values over the 
existing values. Beside each prompt is a list of the supported values that you can enter. Some of these 
lists tell you that you can press F4 (Prompt) if you want to view a more complete list of supported 
values for the current prompt. All of the values you can change are described in Tae guedl 

Manager| beginning on page BG 

4. Press the Enter key to save your changes and exit from the Change Query Manager Profile display. If 
you want to exit without saving your changes, press F3 (Exit) or F12 (Cancel) instead of the Enter 
key. 


You can change all of the values shown on the display except the profile name and description. These 
values are taken from your iSeries user profile and cannot be changed through Query Manager. 


Press F10 (Display additional details) to view the remaining access levels and settings that make up your 
Query Manager profile. The additional details are shown in display-only format. You cannot change any 
values through the Additional Details display. 


Pressing the Enter key takes you to a display that lists all of the SQL statements that you have authority to 
use when you run SQL queries. 


Changing an ALL access profile in Query Manager 


If you have an ALL access level, you have full access to the Queries and Report Forms options, and you 
can change most of the values and settings in your Query Manager profile. You also have full access to 
the Tables option, unless it has been restricted through your Query Manager profile. 


1. Type 10 in the Selection prompt from the Query Manager main menu. 
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2. Press the Enter et An example of the Change Query Manager Profile display for an ALL access user 


is shown in 
j aN 
Change Query Manager Profile 
User profile. 225% ew eS ee FREDNURK 
Deseripeiion) oi weg cts Oe neu see ste ce User Profile for Fred Nurk. 
Type choices, press Enter. 
Default library for QM objects .... *CURLIB Name, *CURLIB 
Default object creation authority *LIBCRTAUT *CHANGE, *ALL, *USE 
*EXCLUDE, *LIBCRTAUT 
Authorization list 
Run:iquery mode: s. 4.20% 2 6% eae ce ul 1=Interactive 
2=Batch 
Number of rows to use for sample... 50_ 1-100 
Display run: options. =... 22 ass Y Y=Yes, N=No 
Confirmation messages in QM ..... Y=Yes, N=No 
Naming convention: % Sos me we vee ss *SYS *SYS, *SAA 
RDB: Gonnection method <5 a x «6 % *RUW *RUW, *DUW 
Default library for QM tables *CURLIB___ Name, *NONE, *CURLIB 
3=Table 
More... 
F3=Exit F4=Prompt F5=Refresh F10=Display additional details 
F12=Cancel F22=QM statement 
You can update only your own profile. e, 


Figure 15. Change Query Manager Profile Display for an ALL Access User 


3. Move the cursor to the prompts for the values you want to change. 
4. Type the new values over the existing values. Beside each prompt is a list of the supported values that 


you can enter. Some of these lists tell you that you can press F4 (Prompt) if you want to view a more 
complete list of supported values for the current prompt. All of the values you can ease are 
described in gen beginning on page 84. 

The More... in the lower right-hand corner indicates that your profile is more than one display in 
length. Use your display station’s roll keys to view and change the remaining settings that make up 
your Query Manager profile. 


The Bottom in the lower right-hand corner tells you that you have reached the end of the profile 
settings. 
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(e > 


Change Query Manager Profile 


WSer protile: = «24 6 «3.8 ao Sa oF FREDNURK 
DESCrIPtiOn: (oasis woe eae ee ts | US er Profile for Fred iNurk. 


Type choices, press Enter. 


Query data output. ©. 0 a ok ss an Hf 1=Display, 2=Printer 
3=File 
Printer to use for output ...... *JOB Name, *JOB 
F4 for list 
File: to use ‘for output «3s 4.403. 3 us *NONE Name, *NONE 
F4 for list 
WSO V2" <a) ce as eden eve eee ak tee sev ce Name, *LIBL, *CURLIB 
Job description for batch run .... *USRPRF___ Name, *USRPRF 
F4 for list 
IDRORY ap otuvaces as cence eusaeaeen wu ene Name, *LIBL, *CURLIB 
Commitment control level ....... 1 1=None, 2=Change 


3=Cursor stability 
4=ALL 5=Repeatable read 
More... 
F3=Exit F4=Prompt F5=Refresh F10=Display additional details 
F12=Cancel F22=QM statement 
eee can update only your own profile. 


Figure 16. Change Query Manager Profile Display for an ALL Access User 


5. Press the Enter key to save your changes and exit from the Change Query Manager Profile display. If 
you want to exit without saving your changes, press F3 (Exit) or F12 (Cancel) instead of the Enter 
key. 


You can change all of the values shown on the displays except for the profile name and description. These 
values are taken from your iSeries user profile and cannot be changed through Query Manager. 


Press F10 (Display additional details) to view the remaining access levels and settings that make up your 
Query Manager profile. The Additional Details are shown in display-only format. You cannot change any 
values through the Additional Details display. 


Pressing the Enter key takes you to a display that lists all of the SQL statements that you have authority to 
use when you create, change, or run SQL queries. 


Security administrator tasks in Query Manager 


Security administrators (users with *SECADM authority) can maintain the Query Manager profiles for 
Query Manager users. As a security administrator, you can display the Query Manager profiles of all users 
for whom you have *READ rights, and can change or copy the profiles of all users for whom you have 
object management (“OBJMGMT) rights. For more information on *SECADM authority, *OBJMGMT rights, 
and *READ rights, refer to iSeries Security Reference. 


Note: *SECADM authority is assigned outside Query Manager. All security administrators need to have 
ALL access levels in their Query Manager profiles. 


Using the work with Query Manager profiles display 


If you have security administrator authority, when you select option 10 (Work with Query Manager profiles) 
from the Query Manager main menu, you see a display similar to the one shown in Folie 7a paged 
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Work with Query Manager Profiles 


Type options, press Enter. 
2=Change 3=Copy 5=Display 


User 
Opt Profile Description 


FREDNURK User profile for Fred Nurk. 
JOESMITH User profile for Joe Smith. 
JONESD David Jones - Accounts. 
LIZARD Night-shift Operator. 
QSECOFR System Administrator. 


[aa see silt tna 


Bottom 
F3=Exit F5=Refresh Fll=Display profile only  F12=Cancel 
F1l6=Repeat position to F17=Position to F22=QM statement 


Figure 17. Work with Query Manager Profiles Display 


This display lists the user IDs for all iSeries users. Not all of the users listed on this display are Query 
Manager users. iSeries users becomes Query Manager users when you grant them the authority to use 
the STRQM command. 


Using the Work with Query Manager Profiles display, you can change, copy, and display Query Manager 
profiles, but you cannot delete a Query Manager profile. If you want to deny complete access to Query 
Manager for some users, remove their authority to use the STRQM command. 


You can choose any of the following options to work with a profile. You need to have *OBJMGMMT rights to 
change or copy a profile, and *READ rights to display a profile. 


2=Change Shows the Change Query Manager Profile display, through which you can change all of 
the access levels and settings that make up a user’s Query Manager profile. See page Ea. 


3=Copy Copies an existing profile. Replaces the default values and settings for specified users. 
This is a quick and easy way to set up profiles for new Query Manager users. See page 


5=Display Shows Query Manager profiles in display-only format. You cannot change any profile 
values through this option. See page 60. 


If you need help selecting profiles from the “Work with” display, see page Lal if you need help using the 
“Work with” display function keys, see page 23. 


Creating a Query Manager profile 


The Query Manager portion of a user’s OS/400 profile is created the first time the user starts Query 
Manager, or the first time a security administrator accesses the profile through this “Work with” display. If 
you select to work with an iSeries user profile for which a Query Manager profile does not yet exist, Query 
Manager creates the Query Manager profile before performing the change, copy, or display. 


The Query Manaper portion of an OS/400 profile is created with all of the default values specified in the 
table on page 
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When you create profiles for new Query Manager users, the only SQL statement they have the authority to 
use when creating, changing, or running SQL queries is the SELECT statement. 


Note: You cannot delete a Query Manager profile. If you want to deny complete access to Query 
Manager for some users, remove their authority to use the STRQM command. 


Displaying a Query Manager profile 

You can display the Query Manager profiles of all users for whom you have *READ rights. You do not 
need to have *OBJMGMT rights to display a profile. The Query Manager profiles are shown in display-only 
format. You cannot change any information through this option. 


1. Type 10 in the Selection prompt from the Query Manager main menu. 

2. Press the Enter key to show the Work with Query Manager Profiles display. 

3. Type 5 in the Opt prompt next to the names of the users whose profiles you want to display. 
4 


Press the Enter key to show the first profile you selected in a Display Query Manager Profile display. 
Display Query Manager Profile displays for the remaining users are shown in the same order as the 
profile names appear in the “Work with” display list. An example of the Display Query Manager Profile 
display is shown in 


(A SS) 
Display Query Manager Profile 
Wser profile. 2 od sa) goa ve we eT FREDNURK 
DESC HIPUION: V2 site peer kentes ssn ese sores en cou User Profile for Fred Nurk. 
Default library for QM objects ....: *CURLIB 
Default object creation authority :  *LIBCRTAUT 
RUMI que rVAMOGO™.. casrsecenc ves ca veres. segue’ Interactive 
Change run query mode .......-.: ~ #&«4J¥eS 
Wsercvaceess: Tevell 5. 20.020 n aves ceed ALL 
Number of rows to use for sample. ..: 50 
Allow interactive sample run.....: Yes 
Maximum number of rows allowed on 
interactive run .......... :  %*NOMAX 
Display run options 2.62 ..6 3 Yes 
Confirmation messages in QM .....: Yes 
Naming convention’ «si. & we soa ee RSYS 
Relational database connection... .:  *NONE 
Press Enter to continue. 
More... 
F3=Exit F12=Cancel F22=QM Statement 
S , y, 


Figure 18. Display Query Manager Profile Display 


The More... in the lower right-hand corner of the display tells you that the profile information is more 
than one display in length. Use your display station’s roll keys to view the entire profile. The final 
display lists the SQL statements that the user can enter when creating or changing queries. 


5. Press the Enter key, F3 (Exit), or F12 (Cancel) when you finish viewing Query Manager profiles, to 
return to the Work with Query Manager Profiles display. 


Changing a Query Manager profile 


You can change the Query Manager profile settings, values, and access levels of all Query Manager users 
for whom you have *OBJMGMT rights. 


1. Type 10 in the Selection prompt from the Query Manager main menu. 
2. Press the Enter key to show the Work with Query Manager Profiles display. 
3. Type 2 in the Opt prompt next to the names of the users whose profiles you want to change. 
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4. Press the Enter key to show the Change Query Manager Profile display for the first profile you 
specified. Change Query Manager Profile displays for the remaining profiles are shown in the same 
order as the profile names appear in the “Work with” display list. An example of the Change Profile 
display is shown in Figs id 


Change Query Manager Profile ) 
User profile: < vs Ss Se ew Se ae FREDNURK 
Description ... 5 6 «se se ee ws 2 2 )6©6USer Profile for Fred Nurk: 
Type choices, press Enter. 
Default library for QM objects .... *CURLIB_ Name, *CURLIB 
Default object creation authority .. *LIBCRTAUT *CHANGE, *ALL, *USE 
*EXCLUDE, *LIBCRTAUT 
Authorization list 
Runsquerny mode: ss. ee a ee ee a 1 1=Interactive 
2=Batch 
Allow change run query mode ..... N Y=Yes, N=No 
Wservaccess' level. os 2. else os 1 1=All, 2=Basic 
Number of rows to use for sample... 50_ 1-100 
Allow interactive sample run..... ¥: Y=Yes, N=No 
Maximum number of rows allowed on 
TINteraGhi ves TUN: 20%. ky kat sae: fe cee os *NOMAX 1-*NOMAX 
Display run options: «<3 % s « % = « if Y=Yes, N=No 
More... 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F22=QM statement y 


Figure 19. Change Query Manager Profile Display for a Security Administrator 


5. Move the cursor to the prompts for the values you want to change. 


6. Type the new values over the existing values. Beside each prompt is a list of the supported values you 
can enter. Some of these lists tell you that you can press F4 (Prompt) if you want to_view a more 
complete list of supported values. All of the values you can change are described in 

agen beginning on page 
You can change all of the values shown on the display except for the profile name and description. 
These values are taken from the user’s OS/400 profile and cannot be changed through Query 
Manager. 

Use your display station’s roll keys to view all of the values that define the user’s Query Manager 
profile. All profiles are shown on multiple displays. 

7. Press the Enter key to save the changes you have made and return to the Work with Query Manager 
Profiles display. If you want to exit from the Change display without saving your changes, press 
F3 (Exit) or F12 (Cancel) instead of the Enter key. 


Selecting allowed SQL statements for profiles in Query Manager 

When you create profiles for new Query Manager users, the only SQL statement they have the authority to 
use when creating, changing, or running SQL queries is the SELECT statement. Users who are upgrading 
from Query Manager V2R1.1 have authority to use all SQL statements. 


To grant or restrict authority for SQL statements, answer YES to “Select allowed SQL statements” (see 


page 45). Query Manager shows the Select Allowed SQL Statements display. An example of this display is 
shown in Ficus 20 on or 5d. 
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Ve ss 
Select Allowed SQL Statements 


Wser protile: << 24 2 «48 294 Sa es FREDNURK 


DESCHIPUION: (latices: eos, ee et ee US er Profile tor Fred iNurk. 


Type options to allow use of the statements, press Enter. 
Press F21 to select all. 


1=Select 
SQL SQL 

Opt Statement Opt Statement 

1 ALTER TABLE _ CREATE PROCEDURE 
— CALL _ CREATE TABLE 

_ COMMENT ON _ CREATE TRIGGER 

— COMMIT _ CREATE VIEW 

_ CREATE ALIAS _ DECLARE GLOBAL TEMPORARY TABLE 
_ CREATE COLLECTION =. “DELETE 

_ CREATE DISTINCT TYPE _ DROP ALIAS 

_ CREATE FUNCTION _ DROP COLLECTION 

_ CREATE INDEX _ DROP DISTINCT TYPE 

More... 


F3=Exit F12=Cancel F21=Select all F22=QM statement 


Figure 20. Select Allowed SQL Statements Display 


Type 1 beside all of the SQL statements that you want the user to be able to use when creating, changing, 
or running SQL queries. Press F21 (Select all) if you want to grant authority for all of the SQL statements. 


To restrict authority to a statement, blank out the 1 typed beside the statement name. If you restrict 
authority to all SQL statements, you stop the user from being able to create, change, or run SQL queries 
through Query Manager. 


When you finish granting authority for SQL statements, press the Enter key to return to the Change Query 
Manager Profile display. 
Notes: 


1. These authorities and restrictions apply only to SQL queries. Users do not need authority for the 
SELECT statement to create, change, or run prompted queries. 


2. These authorities and restrictions apply only when the user is creating, changing, or running SQL 
queries. The user can still display, print, and copy SQL queries that contain all SQL statements. 


3. If you do not grant authority to use the COMMIT and ROLLBACK statements, the user cannot have a 
“Commitment control level” of change, cursor stability, repeatable read, or all. 


4. For acomplete description of all implications when allowing SQL statements, see [Appendix C] 


Special considerations for profiles in Query Manager 

Keep the following in mind when changing Query Manager profiles: 

¢ When you grant and restrict authority for SQL statements, you limit the user’s access for those 
statements when creating, changing, or running SQL queries through Query Manager. This limitation 
does not exist outside Query Manager. 

¢ When you name a specific collection or library for “Default collection for QM tables”, you limit the 
objects and tables that a user with BASIC access can use through Query Manager. This limitation does 
not exist outside Query Manager. 

¢ When you specify a “Relational database connection” of *NONE, users are not automatically connected 
to a remote relational database when they start Query Manager. Users with an ALL access level can 
enter the CONNECT statement from the Query Manager statement line if they want to connect to a 
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remote relational database. See 

elational database architecture (DRDA) in Query Manager’ on page 181}. 

¢ When users are connected to a remote relational database, their commitment control levels might be 
escalated by the connection. To deal with this, Query Manager simulates the commitment control level 
specified in each user’s Query Manager profile, and if necessary, issues COMMIT and ROLLBACK 
statements for the user during the connection to the remote relational database. For more information 
about commitment control, refer to the 


Copying a Query Manager profile 


When you copy a Query Manager profile, you replace the access levels and settings in one profile with the 
access levels and settings from another. This is a quick and easy way to prepare default values and 
settings for new Query Manager users. 


Note: You need to have object management rights (“OBJMGMT) for both the profile you want to copy 
from and the profile you want to copy to. 


1. Type 10 in the Selection prompt from the Query Manager main menu. 
2. Press the Enter key to show the Work with Query Manager Profiles display. 


3. Type 3 in the Opt prompt next to the names of the users whose profiles you want to copy values and 
settings from. 


4. Press the Enter mail to show the Copy Query Manager Profile display. An example of this display is 


shown in 
. >) 
Copy Query Manager Profile 

Type choices, press Enter: 

Replace profile ..... N Y=Yes, N=No 
Type name of existing user, press Enter. 
From Profile To Profile 
FREDNURK JOESMITH___ 

Bottom 

F3=Exit F5=Refresh  F12=Cancel F22=QM statement P, 


Figure 21. Copy Query Manager Profile Display 


5. Answer Y or N to specify whether you want the copy to replace a Query Manager profile that already 
exists. If you selected to copy more than one profile, all profiles are copied using this setting. 


6. Type the names of the profiles you want to copy to. 


7. Press the Enter key to perform the copy and return to the Work with Query Manager Profiles display. 
You need to type existing iSeries user profile names. 


If you want to exit without performing the copy, press F3 (Exit) or F12 (Cancel) instead of the Enter 
key. 


Chapter 3. Working with Query Manager profiles 53 


54 DB2 UDB for iSeries Query Manager Use V5R2 


Chapter 4. Working with Query Manager queries 


A Query Manager query is an SQL statement that you run to manipulate and view database information. 
You can create and maintain queries using Query Manager’s Edit Query display, which provides the syntax 
for all of the SQL statements you have been granted authority to use (through your Query Manager 
profile). You can also create and maintain SELECT statement queries using the prompted query option, 
where a series of displays prompt you to enter all of the information that Query Manager requires to create 
the query. You do not need to be an DB2 UDB for iSeries SQL language expert to work with Query 
Manager queries. 


This chapter begins with a description of queries, telling you what they are, and where and when you 
might find them useful. Following the description are instructions on how to use most of the options that 
are available through the Work with Query Manager Queries display. You can learn how to copy, delete, 
rename, display, and print query definitions, and how to run Query Manager queries. 


Creating and changing query definitions, changing the query creation mode and converting prompted 


ae definitions to SQL query definitions are described in | 


If you have BASIC access to Query Manager, you can display and print query definitions, and run queries. 


What is a query in Query Manager? 


Generally, a query is a question asked of the database. For example, you can use a query to get 
information from database tables to produce a report. All queries created in Query Manager are written in 
the DB2 UDB for iSeries SQL language. Most of the queries you write or run will probably be SQL 
SELECT statement queries, that generate reports on existing database information (for example, to print a 
monthly sales report, a client list, or a supply inventory). 


Creating a Query Manager query 
There are two ways in which you can create Query Manager queries: 


¢ The SQL query editor is suitable for users who have experience using, or who want to learn, the DB2 


UDB for iSeries SQL language. You can create queries containing any of the SQL statements you have 
been (eee ache to use through your Query Manager profile (see [Selecting allowed SOL| 


for more information). Press F4 (Prompt) while 
ia are ein this editor when vial want to view a list of the SQL statements pels ou can use. together 
with their syntax. Creating queries using the SQL query editor is described in 


* The prompted query editor is suitable for users s who have little or no experience using the DB2 UDB for 
iSeries SQL language. A series of displays prompt you to enter all of the information that Query 
Manager requires to create a SELECT statement query. Creating queries using the prompted que 


Committing and rolling back changes to the database 


Using Query Manager, you can run queries that contain all SQL statements you have authority to use 
(granted through your Query Manager profile) except for the CONNECT, SET CONNECTION, RELEASE, 
and DISCONNECT statements. When you run a query that contains one of the following SQL statements, 
you might be responsible for committing or rolling back changes to the database: 
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ALTER TABLE DROP LABEL ON 


CALL GRANT REVOKE 
COMMENT ON INSERT SELECT 
CREATE SET TRANSACTION 
DELETE UPDATE 


If your Query Manager profile specifies that your commitment lock level is change, cursor stability, all, or 
repeatable read, you are responsible for committing or rolling back any changes to the database. You are 
also responsible for committing or rolling back any changes to the database if a SET TRANSACTION is 
active. These commitment lock levels are described on page 


You might want to create two queries to perform the commit and roll back operations: one containing the 

SQL COMMIT statement, and the other containing the SQL ROLLBACK statement. This way you have the 
required statements ready to run whenever you want to commit or roll back changes. (Creating queries is 
described in 


For more information on writing queries, commitment control, and the SELECT, COMMIT, ROLLBACK, and 


other SQL statements, refer to the [SQL Referencd . 


Using the work with Query Manager queries display 
When you want to create, change, run, or use a query in any way, the Work with Query Manager Queries 
display is the place to begin. 


You select the Work with Query Manager Queries display from the Query Managermain menu. Type 1 in 
the Selection prompt; then press the Enter key to go to the Work with Query Manager Queries display. An 
example of this display for a user with an ALL access level is shown in Figure 24 


If you have a BASIC access level, the only options shown are 5=Display, 6=Print, and 9=Run. 


Work with Query Manager Queries 


En ilo) Grell Auereeeranrrucce eerie ree MYLIB Name, F4 for list 
Query creation mode .... SQL 


Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 5=Display 6=Print 


7=Rename 9=Run 10=Convert to SQL 

Opt Query Type Description 

~ FINAL PROMPT 

_  MYQUERY SQL Example query for DB2 UDB for iSeries Query Manager 

_ TABLE PROMPT 

Bottom 

F3=Exit F4=Prompt F5=Refresh Fll=Display query only  F12=Cancel 

Fl6=Repeat position to F17=Position to F24=More keys 
X yy 
4 ; ~ 
Cans query creation mode F22=QM statement F24=More keys ) 


Figure 22. Work with Query Manager Queries Display 
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The queries listed on this display are those stored in the library shown at the top of the display. 


If you have an ALL access level, the library name is underlined, indicating that it is a prompt value. You 
can type a new library name over the existing name if you want to access queries from a different library. 
Position the cursor on the Library prompt, and press F4 (Prompt) to display a list of libraries from which 
you can make a selection. 


If you have an ALL access level, you also see the “Query creation mode” shown under the library name. 
This is the default or current mode that you use to create queries. Most users can change this value by 
pressing F19_ (Change query creation mode). Creating queries and changing the query creation mode is 
described in L 


You can choose any of the following options to work with a query: 


1=Create Shows either the Edit Query display or the Define Prompted Query display, depending on 
your current query creation mode. The query you create becomes the active query. 
bes SQL queries is described on page Creating prompted queries is described on 
page 184. 


2=Change Shows the selected query in either the Edit Query display or the Define Prompted Query 
display, depending on the mode in which the query was last saved. The changed query 
becomes the active query. See page 


3=Copy Copies a query. You can replace an existing query or create a new one. See page al 


4=Delete Deletes queries you no longer require. You need to respond to a confirm display before 
the delete occurs. See page bd. 


5=Display Shows the definition of the selected query in display-only format. You cannot change any 
values through this option. Note that the query is displayed in the mode in which it was 
last saved, either SQL or prompted. See page [59. 


6=Print Sends a copy of the SQL statement that defines the selected query to the printer specified 
in your Query Manager profile. See page 


7=Rename Prompts you to specify new names for existing queries. See page 63. 


9=Run Runs the selected query. You can run any prompted query, and only those SQL queries 
that contain SQL statements you have been granted authority to use (through your Query 
Manager profile). Before an SQL SELECT statement query or prompted query is run, you 
can specify run options such as the mode in which you want to run the query (batch or 
interactive), and the destination to which you want the query output directed (display, 
printer, or table). Before a SQL query runs (except for SELECT queries), you can specify 
the mode (batch or interactive) in which you want to run the query. This query becomes 
the active query and the data retrieved becomes the active data. If you specify a report 
form to format the query data, that report form becomes the active form. See page Ed 


10=Convert to SQL 
Converts a prompted query to an SQL query. You can replace the existing prompted query 
definition with the converted SQL query, or you can create a new SQL query, and leave 
the promptedquery definition unchanged. See page : 


Note: This option is shown only if you have authority to create and change queries using 
the SQL query creation mode. You cannot convert a query if you do not have 
authority to use the SELECT statement. 


If you need help selecting queries from the “Work with” display, see page Lid. If you need help using the 
“Work with” display function keys, see page bd. 
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Copying a query in Query Manager 


When you copy a query, you can create a new query or replace an existing one. 


1. 


Type 1 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Queries display. 
Type 3 in the Opt prompt next to the names of the queries you want to copy; then press the Enter key 


to go to the Copy Query display. This display lists the names of all of the queries you specified. An 
example of this display is shown in Figura 24 


Brom) iibrany’2. gece: a eee 3° IMYELB 


Type information, press Enter: 


To rename copied query, change To Query name. 


From Query To Query 
VENDINFO VENDINFO__ 


ae F5=Refresh  F12=Cancel F22=QM statement 


Copy Query 


Trocilnibrany 2c es ec eb eo te os MYLIB Name 
Replace query ....... N Y=Yes, N=No 


Bottom 


Figure 23. Copy Query Display 


3. 


Before you can copy a query, you need to specify the following information. If you are copying more 
than one query, all queries are copied using the same settings. 


* To library. Type the name of the library to which you want the query copied. 

¢ Replace query. Type Y if you want to replace an existing query, or N if you want to create a new 
query. The default is N. 

Type the name of the query you want to create or replace in response to the “To Query” prompt. If you 

answered N to “Replace query”, the name you type cannot already exist in the specified library. 

Query naming conventions are described on page bal 

Press the Enter key to perform the copy and return to the Work with Query Manager Queries display. If 

you want to leave the Copy Query display without copying any queries, press F3 (Exit) or 

F12 (Cancel) instead of the Enter key. 


Deleting a query in Query Manager 


When you choose to delete a query, Query Manager shows a confirm display. No queries are deleted until 
you respond to this display. 


Te 


58 


Type 1 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Queries display. 


Type 4 in the Opt prompt next to the names of the queries you want to delete; then press the Enter 
key to go to the Confirm Delete of Query display. This display lists the names of all of the queries you 
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selected to delete. An example of the Confirm Delete of Query display is shown in Figure 24 . 


Confirm Delete of Query 
LqiDRanVim 7 ee coke epee eee ete» MYLTB 


Press Enter to confirm your choices for 4=Delete. 
Press Fl2 to return to change your choices. 


Opt Query Description 
4 TUTQRY Tutorial Query 


Bottom 
Fll=Display query only  F12=Cancel oy 


Figure 24. Confirm Delete of Query Display 


When you choose to delete more than one query, you may want to press F11 (Display query only) to 
hide the query descriptions, and show multiple columns of query names on the display. 

Press the Enter key to confirm the delete and return to the Work with Query Manager Queries display. 
Note that when you press the Enter key, you delete all of the queries shown on the display. If you want 
to leave the display without deleting any queries, press F12 (Cancel) instead of the Enter key. 


Displaying a query in Query Manager 


You can view the definition of a query in display-only format. The definition is displayed in the mode in 
which the query was last saved. SQL queries are shown in a display similar to the Edit Query display, and 
prompted queries are shown in displays similar to the Define Prompted Query displays. You cannot 
change any values through these displays. 


Note: Displaying a query definition does not make the query active. 


1. 


Type 1 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Queries display. 

Type 5 in the Opt prompt next to the names of the queries whose definitions you want to display; then 
press the Enter key to go to the Display Query option. The definition of the first query you specified is 
shown. The definitions of the remaining queries are shown in the same order as the query names 
appear in the “Work with” display list. 


An example of an SQL query definition is shown in igure 25 on page 601 
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Display Query 
Columns... : 1 68 Query . . .. . : MYQUERY 
OMics 


KRKKKEKKAKEEKKEKKEREEEEKE BEGINNING OF data *xxxxKKAKKAKAKKKEKRKKEKE 
0001.00 SELECT DEPT, NAME, JOB, SALARY, COMM 
0002.00 FROM MYCOLL.STAFF 
0003.00 WHERE DEPT = 20 OR DEPT = 38 
0004.00 ORDER BY DEPT, JOB 


KR KKKK KERR KK KEKE RKRKKEKEEREEERK End OF data xe KKKK AA KKKR KKK KKK KEKE RKKE 


Bottom 
F2=Alternate keys F3=Exit F4=Prompt F5=Run report F6=Run sample 
F9=Retrieve F24=More keys 
Ne y/ 
is 3 ~ 
F2=Base keys F3=Exit F4=Prompt F5=Refresh F6=Run sample 
F9=Retrieve F24=More keys 
Ne 7 
‘e ; * 
Fl0=Cursor F13=Display form Fl6=Repeat find 
ace F20=Right F21=System command F24=More keys ) 


Figure 25. Display SQL Query Display 


3. When you are viewing the definition of an SQL query, if the definition is more than one display in 
length or width, you can view the entire query in the following ways: 


* Use your display station’s roll keys and the F19 (Left) and F20 (Right) function keys (see page (7a). 


¢ Type the TOP, BOTTOM, LEFT, RIGHT, and FIND editing commands on the Query Manager 
statement line (See page Za). 


¢ Type the nnn go to line command on any line sequence number (see page 72). 


An example of a prompted query definition selection list is shown in [Figure 26 on page 611 
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Display Prompted Query 
Query = 3 3 6s = %  MYQUERY 


Type options, press Enter. Press F21 to select all. 
1=Select 


Opt Prompted Query Selection 
> Specify tables 
Define expressions 
> Select and sequence columns 
> Specify row selections 
> Select sort columns 
Specify summary functions 
Specify duplicate rows 
Specify report formatting 


Bottom 
F3=Exit F5=Run report F6=Run sample  F12=Cancel F18=Display SQL 
F21=Select all F22=QM statement 


Figure 26. Display Prompted Query Display 


4. When you are viewing the definition of a prompted query, type 1 in the Opt prompt next to the parts of 
the query definition that you want to display; then press the Enter key. A “>” sign is shown beside all 
parts of the query that have been defined. You can choose to display all parts by pressing F21 (Select 
all). Displays for the parts you choose are shown in the same order as the part descriptions appear on 
the Display Prompted Query display. When you finish viewing one display, press the Enter key to go to 
the next display. When you finish viewing all of the parts you selected, press the Enter key to return to 
the Display Prompted Query display. 


You can find descriptions of the query definition parts on the following pages: 
Specify tables 
Define expressions 


Select and sequence columns 


Specify row selections 05 
Select sort columns Lod 


Specify summary functions 
Specify duplicate rows Loa) 


Specify report formatting Lol 
5. You can perform the following tasks through these displays: 

e Run a query. 
Press F5 (Run report) to run a full query, or F6 (Run sample) to run a sample query. When you run 
queries in this way, you are prompted to enter run options if the query meets either of the following 
criteria: 
a. The query is an SQL SELECT statement or prompted query, and the Display run options prompt 

is set to YESin your Query Manager profile (see page Bch 


b. The active form does not match the displayed query. 
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6. 


If the query is not a SELECT statement, you are prompted to enter only the mode (batch or 
interactive). For the report form and query to match, they need to have the same number of 
columns, and the columns need to have compatible data types and lengths. Running queries is 
described on page 


* View the definition of the report form used to format the query data. 


If you are viewing the definition of a prompted query, type 1 in the Opt prompt beside “Specify report 
formatting” and press the Enter key. The Specify Report Formatting display is shown, asking you to 
enter the name of the report form you want to display. Type a name, or press F4 (Prompt) to 

display a list of the report forms in the current library from which you can make a selection. (See 

G for more information.) 


If you are viewing the definition of an SQL query, press F13 (Display form) to view the definition of 
a report form. A prompt display is shown, asking you to type the name of the report form you want 
to display. Type a name, or press F4 (Prompt) to display a list of the report forms in the current 
library from which you can make a selection. 


The report form you specify is shown in displays similar to the Select Report Format displays. You 
cannot change any values through these displays. Press F13 (Display query) when you want to 
leave the Display Report Format displays and return to the Display Query or Display Prompted 
Query display. 
¢ View the SQL SELECT statement defined by the prompted query. 
Press F18 (Display SQL) to show the SELECT statement that results from the information entered 
on the Display Prompted Query displays. The SELECT statement is shown with descriptive 
comments, in the same format as prompted query definitions are printed. See Eigura 27 on paga Gd 
for an example of format in which the SQL statement is presented. 
When you finish viewing the query, press F3 (Exit) to return to the Work with Query Manager Queries 
display. If you are viewing the definition of an SQL query, and the Query Manager statement line is 
blank, you can also press the Enter key to leave the Display Query display. 


Printing a query in Query Manager 


You can print the SQL statement that defines a query on the default printer specified in your Query 
Manager profile. 


1. 


Type 1 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Queries display. 


Type 6 in the Opt prompt next to the names of the queries whose definitions you want to print; then 
press the Enter key to send the query definitions to your default printer. If you choose to print more 
than one query, the queries are printed in the same order as their names appear in the “Work with” 
display list. 

A message at the bottom of the display tells you when the query definitions have been successfully 
sent to print. Examples of printed SQL and prompted queries are shown in 


The query definition is sent to the default printer specified in your Query Manager profile. To print the 
definition at a different printer, you need to change the default printer setting in your profile before you 
choose to print the query (see page |42). 


Query definitions are always printed in interactive mode. The “Run query mode” setting in your Query 
Manager profile has no effect on the way definitions are printed. 
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DB2 Query Management 0S/400 


Page il 
5763ST1 V3RIMO 940415 RCHASLOG 
QUEPY 6. ome wl ew a ow He a we SQLQRY 
LibVary «. « 4% SS Haw ee MYLIB 
Sort sequence .......... :  *JOBRUN 
Language identifier ....... :  *JOBRUN 
TEXT. se. ck eG ae oe Bee ae Sample SQL Query for DB2 UDB for iSeries Query Manager 
SEQNBR, #30:0 #4 s02LeousPaeaslsedvtvawedenes Hi Aces beet De sea a Oe acteesrtoiwets 124 0se00 teed 


000001 SELECT DEPT, NAME, JOB, SALARY, COMM 


000002 FROM MYCOLL.STAFF 
000003 WHERE DEPT = 20 OR DEPT = 38 
000004 ORDER BY DEPT, NAME 
* * * * * END OF SOURCE * * * * * 
DB2 Query Management 0S/400 

Page il 
5763ST1 V3RIMO 940415 RCHASLOG 
QUERY. 6 boa eS ae ee we a ee © (PROMPTQRY 

LADRAVY x. 6 2 we aice- ss ww: Scar S MYLIB 
Sort sequence .......... : *JOBRUN 
Language identifier .......:  *JOBRUN 
TOXE: ek ow ee we Rs es ew a 8 Sample Prompted Query for DB2 UDB for iSeries Query Manager 
SEQNBR. #30.0feies Lesgabivesleacet eves sae o« Hig iA edie Poae 60 seer Hews O neasteeael aie etade sO ote eeed 


000001 SELECT 
000002 -- Columns 


000003 A.DEPT, A.NAME, A.JOB, A.SALARY, A.COMM 
000004 -- Tables 
000005 FROM "MYCOLL"/"STAFF" A 


000006 -- Row Selection 

000007 WHERE ((DEPT = 20) 
000008 OR (DEPT = 38)) 
000009 -- Sort Columns 

000010 ORDER BY A.DEPT, A.NAME 


KKK KK 


END OF SOURCE 


kK KKK 


Figure 27. Examples of Printed SQL and Prompted Queries 


Renaming a query in Query Manager 


You can specify new names for more than one query in a single operation. 


1. Type 1 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Queries display. 


2. Type 7 in the Opt prompt next to the names of the queries you want to rename; then press the Enter 


key to go to the Rename Query display. This display lists the names of all of the queries you specified. 
An example of this display is shown in SO ONTEeT | 
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Rename Query 
LSD Vgiecncemes ernewtoer cn teancstan tue LTB: 
To rename query, type New Name, press Enter. 


Query New Name 
VENDINFO VENDINFO___ 


Bottom 


Gageiks F5=Refresh  F12=Cancel F22=QM statement 


Figure 28. Rename Query Display 


3. Type the new name for the query. Query naming conventions are described on page bd. You need to 
enter a query name that does not already exist in the current library. You cannot use the rename 
option to replace existing queries. 


If you choose to rename more than one query, you need to type new names for all of the queries 
before pressing the Enter key. 


4. Press the Enter key to perform the rename and return to the Work with Query Manager Queries 
display. If you want to leave this display without renaming any queries, press F3 (Exit) or 
F12 (Cancel) instead of the Enter key. 


Running a query in Query Manager 


You can run prompted queries and any SQL query that contains one of the SQL statements you have 
authority to use (see page 45). 


When you run SQL SELECT statement queries or prompted queries from a “Work with” display, you are 
always prompted to enter run options. You can specify in your Query Manager profile whether you want 
run options to be displayed. This setting applies only when you run a query as the result of pressing a 
function key. 


1. Type 1 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Queries display. 


2. Type 9 in the Opt prompt next to the names of the queries you want to run; then press the Enter key to 
go to the Run Query display. The Run Query display is shown for the first query you specified. Run 
Query displays for the remaining queries are shown in the same order as the query names appear in 
the “Work with” display list. See 
description of the Run Query display. 


Note: When you run an SQL query that is not a SELECT statement, the Run Query display is not 
shown. Queries are run using the default “Run query mode” specified in your Query Manager 
profile. 

3. Specify the run options you want Query Manager to use when the query is run. Turn to [Specifying runl 
44) for a description of the available run options. 
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4. Press the Enter key to run the query. If there are any variables (strings starting with an ampersand (&)) 
in the query, Query Manager prompts you to enter a value for each variable before the query is run. 
The values you enter are substituted into the query when it is run. 


The query is run using the options you specify on the run options display: 


* If the query was submitted to batch, the Work with Query Manager Queries display is shown ready 
for you to perform the next task. 

* If the query was run interactively and the output sent to a printer or table, you need to wait for the 
query to complete running before the Work with Query Manager Queries display is shown. 

* If the query was run interactively and the output sent to display, you see the results of the query 
(and report form) shown on your display. Press F3 (Exit) or F12 (Cancel) when you want to leave 
the display and return to the Work with Query Manager Queries display. 


Note: When a query is run in interactive mode, the number of rows retrieved might be limited by your 


Query Manager profile (see x 2 
Seneca ane) If the maximum number of rows has been reached but there are more 


rows to be retrieved, all final summary data is omitted from the report, and a message is shown 
telling you that the data is incomplete. 


For a more complete description of running queries, see k 
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Chapter 5. Creating and changing queries in Query Manager 


This chapter describes the ways in which users with an ALL access level can create and change Query 
Manager queries. A Query Manager query is an SQL statement that you run to manipulate and view 
database information. 


The chapter begins with a general overview of the ways in which you create and change queries, and 
describes the two query creation modes available through Query Manager: prompted and SQL. The 
overview also includes instructions on how to run queries from the editors, and include constants and 
variables in queries. This is followed by instructions for creating and changing queries, saving query 
definitions, and converting prompted queries to SQL. 


Creating and changing a query in Query Manager 


You create and change queries through the Work with Query Manager Queries display. To create a query, 
type 1 in the Opt prompt next to the blank query name (at the top of the list). To change a query, type 2 in 
the Opt prompt next to the name of the query you want to change. 


Queries are created in the “Query creation mode” shown at the top of the display, either SQL or PROMPT. 
Many users can change this mode by pressing F19 (Change query creation mode). Queries are changed 
in the “Query creation mode” in which they were last saved. The change mode for each query is shown in 
the “Type” column on the Work with Query Manager Queries display. 


The Work with cae Manager Queries display is described in detail in 


You can create and change Query Manager queries only if you have an ALL user access level. 


The difference between prompted and SQL queries in Query Manager 
Using Query Manager, you can create two different kinds of queries: SQL and prompted. These queries 
are created, changed, and displayed in different modes, and the query definitions are stored in different 
formats. 


SQL These queries are created through the Edit Query display. They can contain any SQL 
statement that you were granted authority to use through your Query Manager profile (see 


fompaton: If you need help iene an SQL statement to define a query, press 
F4 (Prompt) for a list of the statements you have authority to use, and their syntax. 


The SQL query creation mode is suitable for users who have experience using, or want to 


Note: SQL queries cannot contain the CONNECT, DISCONNECT, SET CONNECTION, or 
RELEASE statements. 


Prompted These queries are created through the Define Prompted Query displays. A series of 
displays prompt you to enter all of the information that Query Manager requires to create 
an SQL SELECT statement query. Prompted queries cannot contain subqueries or 
variables. 


The prompted query creation mode is suitable for users with little or no experience using 
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Note: You need to be connected to an iSeries database before you can use the prompted 
query creation mode. 


Changing the query creation mode in Query Manager 


The default mode in which you create queries is set in your Query Manager profile. Many users can 
change this mode, either through their Query Manager profiles, or by pressing F19 (Change query 
creation mode) from the Work with Query Manager Queries display. 


The query creation mode currently selected is shown at the top of the Work with Query Manager Queries 
display. All queries are created using this mode. Changing the query creation mode has no effect on 
queries that have already been created and saved. Queries are changed and displayed in the mode in 
which they were last saved, which is not necessarily the query creation mode shown on the “Work with” 


display. (The creation mode for_each om is shown in the “Type” column on the Work with Query 


Manager Queries display, see .) 


If “Allow change query creation mode” is set to NO in your Query Manager profile, you cannot change the 
mode through your profile, and F19 (Change query creation mode) is not available through the Work with 
Query Manager Queries display. All queries you create through Query Manager are created using the 
mode specified in your Query Manager profile. Also, you can change only those queries that were saved 


using the mode specified in your profile. See 
eCeeE for more information. 


Testing a query in Query Manager 


It is often helpful to run a query while you are defining it, to make sure that it is retrieving the correct data 
and achieving the results you require. 


You can run the query that you are currently creating or changing from the Edit Query display and from 
most of the Define Prompted Query displays. Press F5 (Run report) if you want to run a full query, or 

F6 a to run the query using the sample restriction. Sample queries and reports are described 
on page &. 


You cannot run a query in batch mode if it has not yet been named and saved. Query Sen Bae shows the 
Exit displa 


and will not submit the query to batchuntil it has been named and saved. See 
O7| for instructions. 


Any changes made to the query since it was last saved are included if you run the query in interactive 
mode, and ignored if you run it in batch. If you run the query in batch, a message tells you that the most 
recently saved version of the query is being run. When you return to the query editor, your changes are 
still there. Running the previously saved version of the query in batch mode has no effect on the version of 
the query you are editing. 


Before the query is run, Query Manager checks the syntax. If the query is an SQL query that contains 
variables, you are prompted to enter values for the variables before the syntax can be checked. If the 
query contains any errors, the run is stopped, the cursor is positioned on the first error (if possible), and an 
error message is displayed. If there are no errors, Query Manager runs the query. Running queries is 
described in detail in | RB 


Note that when you run a query by pressing a function key, the program displays options if the query is an 
SQL SELECT statement or a prompted query, and if Display run options is set to YES in your Query 
Manager profile. If the query is not a SELECT statement, only the mode (batch or interactive) option 
appears. See page Bol for more information. 
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Running an alternative query in Query Manager 


You can also run a query by entering the RUN QUERY statement on the Query Manager statement line. 
When you enter the RUN QUERY statement, or when you press F5 (Run report) or F6 (Run sample) and 
run options are displayed, you can choose to run a query other than the one you are currently creating 


changing. (See EB 
for instructions.) 


The Exit display is shown before the quer 
uery that you are currently editing. (See 
bage 10d for instructions.) 


When a query is run interactively, it becomes the active query. If you return to the query editor after 
running a query interactively, the new active query is shown in the editor in place of the query you were 
previously editing, if possible. The active query is shown in the editor that matches the mode in which it 
was last saved, either SQL or prompted. 


If you cannot change your query creation mode, you cannot edit a query that was saved in the mode that 
you do not have authority to use. For example, if your default query creation mode is prompted and you 
cannot change your query creation mode, you cannot edit the active query if it was last saved as an SQL 
query. 


If you run a query interactively that was last saved in the mode that you do not have authority to use, and 
then return to the query editor, the query you were previously creating or changing is shown in the editor. 
The query that you run becomes the active query only if you exit from the editor before running the query. 


Including constants in queries in Query Manager 


A constant is a value that is unchanging and predefined, and is used in processing. In the example: 


SELECT DEPT, NAME, JOB, SALARY, COMM 
FROM MYCOLL.STAFF 
WHERE DEPT = 28 OR JOB = 'Sales' 


28 and ‘Sales’ are constants. You can include constants in SQL queries, and in the expressions and row 
selection tests that you define for prompted queries. 


When you use a character constant, the following rules apply: 
* Enclose the character constant in single quotation marks (for example, 'ABCD'). 


¢ If you want to include a single quotation mark in the character string, you need to type it twice (for 
example, ‘October's Profits'). 


When you use a graphic constant, the following rule applies: 


¢ The delimited DBCS characters in the constant need to begin with a G or g, be enclosed in single 
quotation marks, and be delimited by shift-out and shift-in characters. The following examples use “<” to 
indicate the shift-out character, and “>” to indicate the shift-in character: G'<A B C >' org'<D E F >'. 


When you use a numeric constant, the following rules apply: 


* The maximum length allowed for most numeric values is 31 digits. Single-precision floating-point values 
can be a maximum of 9 digits, and double-precision floating-point values can be a maximum of 17 
digits. 

¢ Place negative signs directly in front of the left-most digit, with no space between the sign and the digit. 
For example, type -5000 instead of - 5000. 


* Do not use a currency symbol (for example, $5000) or a thousand separator (for example, 5,000). 
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Including variables in SQL queries in Query Manager 


A variable is a value that can be changed. By including variables in an SQL query, you can run a single 
query to generate a number of different results. For example, when you define a query, you can enter the 
name of the table being queried as a variable. Then, each time the query is run, users can specify the 
name of a different table to be queried. 


You identify variables in SQL queries by typing an ampersand (&) before the variable name. For example: 


SELECT DEPT, NAME, JOB, SALARY, COMM 
FROM &TABLE 
WHERE DEPT > &COND1 
ORDER BY DEPT, NAME 


Query Manager needs you to supply values for all variables before it can check the syntax of the query, or 
run the query. You are prompted to enter a value for each variable. The query validation or run will fail if 
you do not specify a valid value for each variable. 


Note that when you create or change an SQL query, you cannot enter variables through the Specify “SQL” 
Statement displays that are shown when you press F4 (Prompt). If the query already contains variables, 
F4 (Prompt) is not supported. (See 
more information.) 


Note: Prompted queries cannot contain variables. 


Creating customized run-time prompts for variables in Query Manager 


If your SQL query contains variables, Query Manager prompts you to enter values for each variable before 
the query can be validated or run. Using the method described over the following pages, you can create a 
display containing customized prompts that ask users to enter specific values for each variable when the 
query is run. 


You need to create a control language (CL) program to define the display on which the run-time prompts 
are shown, and a command that fills in the appropriate information for the prompts on the display. (You 
can also accomplish the same thing by creating a CL program and a DDS source file to define the 
display.) 


The following examples are based on the STAFF table (shown on page g) and the SALARYQ2 query and 
SALARYR2 report form, shown in Eigure 29). 


SALARYQ2 Query 

SELECT DEPT, NAME, ID, JOB, YEARS, SALARY, COMM 
FROM MYCOLL. STAFF 
WHERE DEPT = &COND1 AND SALARY < &COND2 
ORDER BY DEPT, SALARY 

SALARYR2 Report Form 

Column 1 (DEPT) Usage = BREAK1 

Column 5 (YEARS) Usage = AVERAGE 

Column 6 (SALARY) Usage = AVERAGE 


Break 1 Footing Text: Line Align Text 
1 RIGHT Dept Avg: 


Figure 29. Example Query and Report Form for Customized Prompts 


You could create two additional report forms, called BYDEPT and BYDIVISION, with different formatting 
and calculations. 
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The example CL program and command shown in Figure 31 on page 74 create the display shown in 


Figure 30. This display shows customized prompts, asking the user to enter specific values for &COND1, 


&COND2, output destination, and report form to use. 


Department Report (DEPTREP) 


Type choices, press Enter. 


Department to report on... . 10____ 10, 20, 30, 40, 50 

With salary less than. .... 100000 Character value 

Qutput location. « % <2 6. 4s * *, *PRINT 

Report form name ....... SALARYR2__ BYDEPT, BYDIVISION, 
SALARYR2 


Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel 
F13=How to use this display F24=More keys 


a 


Figure 30. Customized Run-Time Prompts Display 
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Example CL Program 
SEU Source Listing 
SOURCE. FILE <6 a. wa): wi cae ee EXAMPLE. SOURCE 
MEMBER: ss. se: sece. 6 se fer carat ah A CLPGM 
SEQNBR¥ xecticcce 1 wastage, 2 davtties 3 auatew 4 ductece 5 aatinenb ase 
100 PGM PARM(&VAR1 &VAR2 &VAR3 &VAR4) 
200 DCL &VAR1 *CHAR LEN(6) 
300 DCL &VAR2 *CHAR LEN(6) 
400 DCL &VAR3 *CHAR LEN(6) 
500 DCL &VAR4 *CHAR LEN(10) 
600 STRQMQRY QMQRY (EXAMPLE.SALARYQ2) QMFORM(EXAMPLE.&VAR4) + 


700 OUTPUT (&VAR3) + 
800 SETVAR((COND1 &VAR1) (COND2 &VAR2)) 
900 ENDPGM 


x x * * END OF SOURCE * * * * 


Example Command 
SEU Source Listing 
SOURCE FILE ss. ow i wi EXAMPLE. SOURCE 
MEMBER’: hie -8i go ar 8 Re die Re Se nee CLPGM 
SEQNBR¥ isc ol smetinii2 senthias 3 aavtene & weettdaw 5 nae te coke 
100 CMD PROMPT('Department Report') 


200 PARM KWD(VAR1) TYPE(*CHAR) LEN(6) RSTD(*YES) + 
300 DFT(10) VALUES(10, 20, 30, 40, 50) + 
400 PROMPT('Department to report on') 

500 PARM KWD(VAR2) TYPE(*CHAR) LEN(6) DFT(100000) + 
600 PROMPT('With salary less than') 

700 PARM KWD(VAR3) TYPE(*CHAR) LEN(6) RSTD(*YES) + 
800 DFT(*) VALUES(*, *PRINT) + 
900 PROMPT('Output location') 

1000 PARM KWD(VAR4) TYPE(*CHAR) LEN(10) RSTD(*YES) + 
1100 DFT(SALARYR2) VALUES(BYDEPT, BYDIVISION, + 
1200 SALARYR2) PROMPT(Report form name') 


* * * * END OF SOURCE * * * * 


Figure 31. Example CL Program and Command to Create Customized Prompts 


When you enter the EXAMPLE.DEPTREP command through the command window and press 
F4 (Prompt), you see the display shown in See Tee This display shows customized prompts, 
asking the user to enter specific information before the SALARYQ2 query is run. 


You can enter any of the values shown on this display, or press the Enter key to accept the default values. 
The following report shows an example of what you might see if you accept the default values from the 
customized prompt display: 


DEPT NAME ID JOB YEARS SALARY COMM 
10 Daniels 240 Mgr 5 19,260.25 .00 
Lu 210 Mgr 10 20,010.00 00 
Jones 260 Mgr 12 21,234.00 .00 
Molinare 160 Mgr 7 22,959.20 00 

Dept Avg: 9 20,865.86 
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Creating an SQL query through the edit query display in Query 
Manager 


If your current query creation mode is SQL, Query Manager shows the Edit Query display when you 
choose to create a query. Using this display, you can create queries containing any one of the SQL 
statements that you have been granted authorit to use through your Query Manager profile (see 

. You can view a list of the 


allowed statements and their syntax by pressing F4 (Prompt). 


1. Type 1 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Queries display. Make sure that your “Query creation mode” (shown at 
the top of the “Work with” display) is SQL. If your creation mode is prompted, press F19 (Change 
query creation mode) to change the mode to SQL. 


Note: Your Query Manager profile might restrict you from changing the query creation mode. See 
page 44 for more information. 


2. Type 1 in the Opt prompt next to the blank query name (at the top of the list). You can specify a name 
for the query now, or you can leave it unnamed and specify a name when you save the query through 
the Exit is Query naming conventions are described on page bd, and saving queries is described 
on page 
Press the Enter key to show the Edit Query display. The editing area contains a set of blank lines with 
the cursor positioned at the start of the first blank line. An example of this display is shown in 


Ny 
Edit Query 
Columns: ey. 3. 1 68 Query . . .. . : MYQUERY 
QM a. 
Type SQL Statement. 
KARKEKE KK KEK EK EK ERA KK EKEKER Beginning OF data KEKKKKKKKKEKKKKEKEKEKKKK 
KRKKKKKAK KERR RREREREREREEER End OF data xR KRKKKKEKKKKKKKEKKKEEEKE 
Bottom 
F2=Alternate keys F3=Exit F4=Prompt F5=Run report  F6=Run sample 
F9=Retrieve F15=Check syntax F24=More keys 
a 
: >) 
F2=Base keys F3=Exit F4=Prompt F5=Refresh F6=Run sample 
F9=Retrieve F15=Check syntax F18=Sort sequence F24=More keys y 
Fl0=Cursor  F13=Edit form F16=Repeat find F17=Repeat change 
F19=Left F20=Right F21=System command F24=More keys 


Figure 32. Edit Query Display 


The following information is provided to help you create a SELECT statement query, but it can be 
applied to any interactive SQL statement you choose, such as COMMIT, ROLLBACK, and CREATE 
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VIEW. Note that you cannot use the Edit Query display to create a query that contains the CONNECT, 
DISCONNECT, SET CONNECTION, or RELEASE statements. 


Type an SQL statement to define the query. (Refer to the for full details of all SQL 
statements.) 


There are three functions to help you write the statement: 


Press F4 (Prompt) to display a list of the SQL statements you have authority to use. You can select 
a specific statement from this list, and press the Enter key to display its syntax. See page [ZO for a 
full description of the query prompting feature. 


Use the Quer Manager DRAW statement to construct the first two clauses of a SELECT statement. 
821 for further information. 


Press F15 (Check syntax) to check the syntax of the entire SQL statement. If the query contains 
variables, Query Manager prompts you to enter values for the variables before it checks the syntax. 
If any error is found, the cursor is positioned on the part of the statement that contains the error (if 
possible), and an error message is displayed. 


Note: F15 (Check syntax) is not supported when you are connected to a non-iSeries relational 
database. 


The name of the query you are creating is shown in the upper right-hand corner of the display. The 
columns of the query you are currently viewing are shown in the upper left-hand corner of the display. 
If you are unable to view the entire query on your display at one time, you can use the F19 (Left) and 
F20 (Right) function keys to change the portion of the query that you are viewing. Queries can be a 
maximum of 79 columns in width. 
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Edit Query 
Columns. a 23 270 Query .. . : MYQUERY 
QM... 


Type SQL Statement 


Sedo dcddoeccccoeee Beginning of Data stddddakiidddniiik kidd 


0001.00 -- query for standard employee report 


0002.00 SELECT ID, NAME, DEPT, JOB -- columns to select 
0003.00 FROM MYCOLL.STAFF -- table to select from 
0004.00 WHERE DEPT > 10 -- select rows only when 
0005.00 -- dept number is > 10 
0006.00 ORDER BY NAME -- sort by employee name 


KR KK KKK K EKER ERK KKKERKERKAKEKEER ENd Of Data 2a KKK K AK KA KER ERR KERR EK 


F2=Alternate keys F3=Exit F4=Prompt F5=Run report F6=Run sample 
F9=Retrieve F15=Check syntax F18=Sort sequence F24=More keys 


y 
Exit 
Type choices, press Enter. 
Optiionis 20 a as 2 1=Save and exit 
2=Exit without save 
3=Resume without save 
4=Save and resume 
QUERY oy serene, werk MYQUERY___ Name 
Library iyo os MYCOLL Name, *CURLIB 
Description .. Select from staff where dept > 10 
F5=Refresh  F12=Cancel 
yy 


Figure 33. Example Query Showing Comments 


4. You can insert comments to describe your query. Identify comments by beginning them with a double 
hyphen (--). Everything from the double hyphen to the end of that line is treated as a comment and is 
stripped from the SQL statement during processing. A comment can start at any point in the line, as 
shown in 


When you use F4 (Prompt) to edit a query, Query Manager removes any formatting (such as extra 
spaces and new lines) from the query statement. The edited statement is inserted in the Edit Query 
display as one continuous line. Any comments that were on the same line as query text are moved to 
the lines following the query statement. Query Manager keeps the comments as close as possible to 
the information that they describe. 


5. To specify the sort sequence and language for the query, press F18 (Sort sequence). The Query 
Manager program shows the Specify Sort Sequence display (See page f04). F19 (Sort sequence) is 
available when: 


¢ The Show query sort sequence option in your Query Manager profile is set to YES. 
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¢ The Show query sort sequence option is set to NO but you are changing a query with a sort 
sequence other than the default. 

6. To run the query, press F5 (Run report) or F6 (Run sample). See page 68] for instructions. 

7. When you finish creating the query, press F3 (Exit) to leave the Edit Query display and show the Exit 
display. Enter a name and description for the query through this display. Query naming conventions 
are described on page 29, and the description can be a maximum of 50 characters in length. If the 
query is already named, you can change the name if you desire. 


Select option 1 to save the query; then press the Enter _key to return to the Work with Query Manager 
Queries display. The Exit display is described on page hod 


If you have not made any changes to the query definition, you can press F12 (Cancel) to leave the 
Edit Query display and return to the Work with Query Manager Queries display. The F12 key is 
available only if you have not made any changes to the query definition. 


If you want to work through 


Appendix A a e exe 


practice exercises in which you create and work with an SQL query, turn to 
eC O 


Using the edit query display in Query Manager 
The Edit Query display provides you with a range of editing features to help you create and change SQL 
queries. You can use: 


¢ Edit commands. These commands are entered on the Query Manager statement line (at the top of the 
display). Use these commands to search for or replace a string of characters in the statement, and to 


move to the top, bottom, right, or left of the editing area. See 
fins Queectenccad 


¢ Line commands. These commands are entered on the line sequence numbers in the edit area. Use 
these commands to insert, delete, repeat, and copy lines, and to go to a specified line number. (Line 
sequence numbers are shown the first time you press the Enter key while you are creating a query.) 


Se the syntax of your query. See 


Entering edit commands on the statement line in Query Manager 

When you want to search for or change a string of characters, or view the entire query, type the following 
editing commands on the Query Manager statement line, shown at the top of the Edit Query display. All 
edit commands can be entered in either uppercase or lowercase letters. 


Find FIND string 


Searches for a string of characters, starting from the line on which the cursor is positioned. If the 
cursor is positioned on the Query Manager statement line, the search starts from the first line 
shown in the edit area. The search is in a forward direction only. If the string is found, the search 
stops and the cursor is positioned at the beginning of the string. To find the next occurrence of the 
same string, press F16 (Repeat find). 


You can abbreviate FIND to F. If the search string includes any blanks or lowercase letters, you 
need to enclose the string in either single or double quotation marks. 


Change 
CHANGE findstring replacestring 


Searches for a string of characters, starting from the line on which the cursor is positioned. If the 
cursor is positioned on the Query Manager statement line, the search starts from the first line 
shown in the edit area. The search is in a forward direction only. If the findstring is found, it is 
replaced by the replacestring, and the cursor is positioned at the line in which the change was 
made. To find the next occurrence of the find string, press F16 (Repeat find). To change the next 
occurrence, press F17 (Repeat change). 
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You can abbreviate CHANGE to C. If the find or replace strings include any blanks or lowercase 
letters, you need to enclose the strings in either single or double quotation marks. If the replace 
string is longer than the search string, the change is not performed, and an error message tells 

you that the text was too long. 


Top _ Positions the first line of the SQL statement at the top of the edit area. You can abbreviate TOP to 


Positions the last line of the SQL statement at the bottom of the edit area. Shows the final lines of 
the query. You can abbreviate BOTTOM to B. 


Left Positions column 1 of the query in the leftmost column of the displayed edit area. The range of 
columns currently shown is indicated in the Columns field at the top of the display. You can 
abbreviate LEFT to L. 


Right Positions column 79 of the query in the rightmost column of the displayed edit area. The range of 
columns currently shown is indicated in the Columns field at the top of the display. You can 
abbreviate RIGHT to R. 


Entering line commands in the SQL editor in Query Manager 

You can type the following line commands over any line sequence number to insert, delete, repeat, or 
copy lines, or to go to a specified line number. When you press the Enter key, the command is performed 
and the line numbers are automatically renumbered so that a continuous sequence is kept, beginning with 
0001.00. 


Line sequence numbers are shown the first time you press the Enter key while you are creating a query. 


The line commands available through the Edit Query display are: 


nnn — Goto. Repositions the display with the line numbered nnn at the top of the edit area. If you specify 
a number that is greater than the number of the last line, the last line is positioned at the top of 
the edit area. 


I Inserts one blank line following the current line. If you make any changes to the inserted line 
(typing a space is regarded as a change), pressing the Enter key causes a second blank line to be 
inserted immediately following the first. 


Innn _ Inserts nnn blank lines following the current line. When you press the Enter key, the changed lines 
are kept and another blank line is inserted immediately after the inserted lines. 


D Deletes the current line. 
DD Deletes the block of lines delimited by two DD commands. 


RP Repeats the current line, inserting the copy after the current line. 


Repeats the current line nnn times, inserting the copies after the current line. 
Cc Copies the current line to the position specified by the A (After) or B (Before) command. 


cc Copies the block of lines delimited by two CC commands to the position specified by the A (After) 
or B (Before) command. 


A After. Specifies that one or more lines being copied by the C or CC command are to be inserted 
after this line. 


B Before. Specifies that one or more lines being copied by the C or CC command are to be inserted 
before this line. 


When you insert, repeat, and copy lines, keep in mind that the maximum size permitted for a query is 
9999 lines or 32K, whichever limit you reach first. 


Chapter 5. Creating and changing queries in Query Manager 77 


Line commands are subject to the following rules: 


Line commands can be typed using either uppercase or lowercase letters. 

No commands can be nested within the bounds of two CC or two DD commands. 

Only one command can be specified per line. 

Only one target command can be specified at a time, and therefore only one copy command. 


The only commands you can type on the line immediately above the first numbered line (the “Beginning 
of Data” line) are nnn, |, and A. 


The only commands you can type on the line immediately below the last numbered line (the “End of 
Data” line) are nnn and B. 


You might need to type a space following | and RP commands. If the number of lines (nnn) you want to 
insert or repeat in the query definition is the same as the sequence number on which you are typing the 
line command, you need to type a space following the number of lines. For example, if you are entering 
the command on line sequence number 0012.00, typing RP12.00 repeats the line once, while typing RP12 
00 repeats the line 12 times. 


You might need to use your display station’s roll keys to show lines you insert to the query. Inserted 
lines are not always shown on the current display. 


Example of line commands in Query Manager: The following illustration shows one line being deleted 
and two blank lines being inserted. d is typed on sequence number 0003.00 to delete that line, and i2 is 
typed on sequence number 0004.00 to insert two blank lines immediately following line 0004.00. Note that 
the commands can be typed anywhere on the sequence number; they do not have to be left-aligned. 


KRKKKEKEKEKEKEKEREKEREEE BEGINNING Of data *xxxxKKKKAKAKKKKKKKKEKER 
0001.00 SELECT DEPT, NAME, JOB, SALARY, COMM 
0002.00 FROM MYCOLL.STAFF 
000d.00 WHERE DEPT = 20 OR DEPT = 38 
0004120 ORDER BY DEPT, NAME 


KRKKEKKKRERKEKRERKEREREREEKEKER End OF data «x KKK KKKKKKKKEKKKEKKKEERER 


Press the Enter key to perform the line commands. Note that the lines are renumbered so that a 
continuous sequence is kept. 


KRKKK ERK KEK KEK ERK RR EKER Beginning OF data K*KKKKKKKKKEKKKKKKKEKKEKKR 
0001.00 SELECT DEPT, NAME, JOB, SALARY, COMM 
0002.00 FROM MYCOLL.STAFF 
0003.00 ORDER BY DEPT, NAME 


KKKKK KKK EKKKERKEKEREKKEEKKKEER End OF data 2x RK KK KKKKKKKKKKKEKKKEKKKEK 


Using function keys to edit an SQL query in Query Manager 
The following function keys are provided to help you create and change queries: 


F4 Prompt. When the cursor is in the editing area and no statement is entered, F4 lists the SQL 


statements you have been granted authority to use (through your Query Manager profile). When 
the cursor is in the editing area and an allowed statement or partial statement is entered, F4 
shows you the syntax of the statement, with any parameters you have alread entered filled in. 


The prompting option does not support variables. See 
Manager’ on page 74 When the cursor is on the blank Query Manager statement line, F4 lists the 


supported Query Manager statements. 


F10 Cursor. Moves the cursor from the editing area to the Query Manager statement line, or from the 


Query Manager statement line to the editing area, depending on the present position of the cursor. 


F15 Check syntax. Checks the syntax of the entire SQL statement. If the query contains variables, 


Query Manager prompts you to enter values for the variables before it checks the syntax. If any 
error is found, the cursor is positioned on the part of the statement that contains the error (if 
possible), and an error message is displayed. 
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F16 


F17 


F18 


F19 


F20 


Note: F15 (Check syntax) is not supported when you are connected to a non-iSeries relational 
database. 


Repeat find. Looks for the search string you specified in the last FIND or CHANGE command that 
you entered on the Query Manager statement line. If the search string is found, the cursor is 
positioned on it. A message is displayed indicating the result of the search. 


Repeat change. Repeats the last CHANGE command that you entered on the Query Manager 
statement line. If the search string is found, the change is performed and the cursor is positioned 
on the changed string. A message is displayed indicating the result of the change. 


Sort sequence. Shows the Specify Sort Sequence display. This key is not available when the 
Show query sort sequence options prompt in the Query Manager profile is set to NO. The only 
exception to showing the options is when you change a query that was created with a sort 
sequence other than the default. 


Left. Shows the query with column 1 of the query beginning in the first column of the display. The 
columns of the query that you are currently viewing are shown in the upper left-hand corner of the 
display. Use this key, together with F20 (Right) to view the entire query if it is more than one 
display in width. (A query can be a maximum of 79 characters wide.) 


Right. Shows the query with column 79 of the query ending in the final column of the display. The 

columns of the query that you are currently viewing are shown in the upper left-hand corner of the 

display. Use this key, together with F19 (Left) to view the entire query if it is more than one display 
in width. (A query can be a maximum of 79 characters wide.) 


Prompting for SQL statements in Query Manager 

Press F4 (Prompt) from the Edit Query display when you want to see a list of the supported SQL 
statements and their syntax. Make selections through these prompt displays, and let Query Manager enter 
SQL statements for you. 

Position the cursor in the editing area of the Edit Query display; then press F4 (Prompt) to view SQL 
statement prompting. 


° Ifthe rer area is blank, you see a list of the SQL statements that you have authority to use. See 


1. 


If the editing area contains an authorized SQL statement, you see the syntax of that statement. Any 
valid parameters already entered for the statement are shown in the prompt display. (Note that the 
statement cannot contain any variables.) See 


To choose a statement from the Select SQL Statement display, type its option number in the Selection 
prompt at the bottom of the display and press the Enter key. Query Manager then shows you the 
Specify “SQL” Statement display for the statement you choose. 
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Select SQL Statement 
Select one of the following: 
1. Alter a table definition constraint ALTER TABLE 
2. Call a procedure CALL 
3. Assign a comment to a table or view COMMENT ON 
4. Commit changes to the database COMMIT 
5. Create an SQL alias CREATE ALIAS 
6. Create an SQL collection CREATE COLLECTION 
7. Create a distinct data type CREATE DISTINCT TYPE 
8. Create a user defined function CREATE FUNCTION 
9. Create an SQL index in a collection CREATE INDEX 
10. Create a user defined procedure CREATE PROCEDURE 
11. Create an SQL table in a collection CREATE TABLE 
12. Create a Trigger CREATE TRIGGER 
13. Create a view over an existing table CREATE VIEW 
14. Create a declared global temporary table DECLARE GLOBAL 
More... 
Selection 
F3=Exit F12=Cancel 
\ BY 


Figure 34. Select SQL Statement Display 


The Specify “SQL” Statement display prompts you to enter all parameters for the specified statement. 
Any valid parameters you have already entered are shown in the display. 


Figure 35 on page 81] shows an example of the Specify “SQL” Statement display for the SELECT 
statement. It shows the result of pressing F4 (Prompt) when the editing area contains the following 
statement: 

SELECT * FROM MYCOLL.STAFF WHERE DEPT = 20 


2. Use the Specify “SQL” Statement display to complete the SQL statement. Note that you cannot enter 
variables through these displays. 
Further prompting is available to help you enter parameters. For example, you can move the cursor to 
the ORDER BY prompt and press F4 (Prompt) to display a list of columns for the table named in the 
FROM prompt. 


Note: If you are connected to a remote relational database, prompting for lists of tables and 


collections is not supported. If the remote relational database is an SQL/DS™ database, 
prompting for columns is also not supported. 
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Specify SELECT Statement 


Type information for SELECT statement. Press F4 for a list. 


PROMetabiles:. is. 3 wee yee. MYCOLL. STAFF. 
SELECT ColumnSm<. ss cs 40s * 
WHERE: ‘conditions: <4) & 2. acs DEPT = 20 


GROUP: 'BY ‘columns: % a4. 3 a - 
HAVING conditions ..... 
ORDER BY columns ...... 
FOR UPDATE OF columns 


Bottom 
Type choices, press Enter. 


DISTINCT ‘rows: iin result. table 2... «0.4% >; N Y=Yes, N=No 
UNDTON with another SELEGT (2055-3 soe ee es es N Y=Yes, N=No 
Specify additional options. .......... N Y=Yes, N=No 
F3=Exit F4=Prompt F5=Refresh F6=Insert line F9=Specify subquery 
Fl0=Copy line  F12=Cancel Fl4=Delete line F15=Split line F24=More keys e, 
>) 
F21=Display statement F24=More keys sy 


Figure 35. Specify SELECT Statement Display 


Subqueries are available for any statement that supports a WHERE or HAVING clause. To create a 
subquery, position the cursor on the WHERE or HAVING prompt; then press F9 (Specify subquery) to 
go to the edit subquery display. When you finish defining the subquery, press the Enter key to return to 
the Specify “SQL” Statement display. The subquery is shown as part of the WHERE or HAVING 
clause, enclosed in parentheses. 


3. Press the Enter key when you complete entering the parameters. The SQL statement that results from 
the Specify “SQL” Statement display is inserted in the Edit Query display, provided the syntax of the 
statement is correct. If there are any syntax errors, the Specify “SQL” Statement display is again 
shown, and the cursor is positioned on the error, if possible. 


Note: When you use F4 (Prompt) to edit a query, any formatting you may have entered for the query 
(such as extra spaces and new lines) is discarded when you press the Enter key. Query 
Manager inserts the edited statement in the Edit Query display as one continuous line. Any 
comments you had entered for the query are shown on the lines immediately following the 
query statement. The comments are kept as close as possible to the part of the query that they 
describe. 


For a description of all SQL statements, refer to the SQL Reference . For information on DBCS 
considerations when prompting for SQL statements, refer to the ; 


Allowed and restricted SQL statements in Query Manager 
The statements that you can enter to define your query may be restricted by the security administrator 


through your Query Manager profile. See 
TRS TNTaoe Ce more information. 
Query Manager knows which SQL statements you can and cannot use, and provides F4 (Prompt) 
information for only those statements that you have the authority to use. You cannot save a query that 


contains one of the statements you have not been granted authority to use through your Query Manager 
profile. 
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If the security administrator restricts your access to all SQL statements, you cannot create, change, or run 
SQL queries through Query Manager. 


Using the edit form function key in Query Manager 


If your query is a SELECT statement, you can press F13 (Edit form) to define a report form for use with 
the query. When you define a report form, you can specify things like: 


* Column formatting and headings 
* Page headings and footings 

* Break text 

* Summary operations 

* Text for the end of the report 


For information on defining report forms, see 


Before you press F13 to create or change a report form, it is a good idea to run the query in interactive 
mode (see }). Running a query interactively creates active 
data that Query Manager uses for default values when you define the report form. If your Query Manager 


profile prevents you from running a query in interactive mode, you cannot create active data. Instead, you 
can load default values for the report form from your active query, see TEST AUTRE Te TT 


When you press F 13, if there is no active form, you see a prompt display asking you to type the name of 
the report form you want to create or change, and the library in which it resides. You can press 

F4 (Prompt) to display a list of all report forms in the current library from which you can make a selection. 
Type a new name to create a report form, or type the name of an existing report form that you want to 
change or display. Then press the Enter key to go to the Select Report Format display. The aoe Report 
Format display is described in 


When you finish editing the report form, you can press F13 (Edit query) to leave the Select Report Format 
display and return to the Edit Query display. 


If you do not want to design your own report form, you can specify a report form name of *SYSDFT at the 
time of running a query. Query Manager creates a simple (system default) report form that it uses to 
format the query data. 


Using statements in Query Manager 
You can use the Query Manager statement line at the top of the Edit Query display to type the editing 
commands described on page [Z6l and a number of Query Manager statements supported by Quer 
poreaet The supported Query Manager statements are described in Append 


82  DB2 UDB for iSeries Query Manager Use V5R2 


Edit Query 
Columns’. a « 3 1 68 Query. 3 i 2 a. a MYQUERY 
QM... 


Type SQL Statement. 
KKK KEKE KK ER EKER AKER ER EKER Beginning OF data KEKKKKKAKKKKKKKKEKEKEKKEKK 
Le es i) at TL | 


Figure 36. The Query Manager Statement Line 


The DRDA commands can be executed from the command line. A list of relational databases and their 
connection information can be ebiaiiee by prompting on the DRDA statements. Eo more information on 
DRDA considerations, see [Ch 


Use your display station’s arrow keys or press F10 (Cursor) to move the cursor to the Query Manager 
statement line. When the cursor is positioned on the Query Manager statement line, you can press 
F4 egney to display a list of the supported statements that you can enter (similar to Figure 34 od 


You will probably enter the DRAW, SAVE QUERY AS, and CONNECT statements most often on ae 
statement line. These statements are described in detail in Appendix 


DRAW table 
Adds the SQL statement: 


SELECT columnl, column2, column3, . . . FROM table 


to any text that is currently in the edit area. This statement is particularly helpful when building 
SQL statements that contain subselects. 


SAVE QUERY AS 
Saves the current query using the name you specify. 


CONNECT 
Makes a connection to a different relational database. For example, to connect to an iSeries 
system named CHICAGO, you would type: 


CONNECT TO CHICAGO 


Note that when you create a query in the Edit Query display, the query cannot contain the 
CONNECT, DISCONNECT, SET CONNECTION, or RELEASE statements. 

Notes: 

1. If you CONNECT to a non-DB2 UDB for iSeries, F15 (Check syntax) is not supported. 


2. If you specified SYSTEM naming conventions in your Query Manager profile, the only 
relational databases you can CONNECT to are those on a local machine, or those on another 
iSeries system. 
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Creating a prompted query through the define prompted query display 
in Query Manager 


If your current query creation mode is prompted, Query Manager shows the Define Prompted Query 
display when you choose to create a query. Using this display, you can create a SELECT statement query. 
Choose the parts of the query that you want to define; then press the Enter key. 


Query Manager presents a series of “prompted” displays. Answer the prompts on these displays to provide 
Query Manager with all of the information it needs to create the SELECT statement query. 


Note: You cannot create or change a prompted query while you are connected to a non-DB2 UDB for 
iSeries. You can change your current database connection using the Query Manager CONNECT or 
SET CONNECTION statements. See page for instructions. Refer to 


for DRDA considerations. 


gonadal Oalapa q alits 


1. Type 1 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Queries display. Make sure that your “Query creation mode” (shown at 
the top of the “Work with” display) is prompted. If your creation mode is SQL, press F19 (Change 
query creation mode) to change the mode to prompted. 


Note: Your Query Manager profile might restrict you from changing the query creation mode. See 
page 44) for more information. 


2. Type 1 in the Opt prompt next to the blank query name in the Work with Query Manager Queries 
display (at the top of the list). You can specify a name for the query now, or you can leave it unnamed, 
and specify a name when you save the query through the Exit display. Query naming conventions are 
described on page ba and saving queries is described on page hod 
Press the Enter key to show the Define Prompted Query display. This display lists the eight possible 
definition steps you can use to define a query or change part of an existing query definition. An 
example of the Define Prompted Query display is shown in . 


Define Prompted Query 
Query «5 eG 6 x :  MYQUERY 


Type options, press Enter. Press F21 to select all. 
1=Select 


Opt Prompted Query Selection 

1 Specify tables 
Define expressions 
Select and sequence columns 
Select rows 
Select sort columns 
Select summary functions 
Specify duplicate rows 
Specify sort sequence 
Specify report formatting 


Bottom 
F3=Exit F5=Run report F6=Run sample  F12=Cancel F18=Display SQL 
ee evieeea all F22=QM Statement 


Figure 37. Define Prompted Query Display 


3. Type 1 in the Opt prompt next to the definition steps of the query you want to create; then press the 
Enter key. You can choose all definition steps by pressing F21 (Select all). 
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The only definition step that you need to choose when you are creating a query is “Specify tables”. You 
do not need to choose all of the definition steps shown on the display: use only those that you need. 
Most of these steps do not need to be performed in a specific order (although the order shown is 
recommended if you need to use most of them). Each step you select is a separate process that 
shows you one or more displays, as you need them. 


4. Create the query by completing the definition steps that you selected through the Define Prompted 
Query display. 


Specify tables see page 
Define expressions see page 
Select and sequence columns 

see page 
Select rows see page 
Select sort columns see page Lod) 
Select summary functions see page Loal 
Specify duplicate rows see page Los) 
Specify sort sequence see page boa 


Specify report formatting see page Loe 

5. When you finish entering the information for one display, press the Enter key to go to the next display. 
All displays are shown in the same order as the definition steps are listed on the Define Prompted 
Query display. When you finish entering information for all of the definition steps that you selected, 
press the Enter key to return to the Define Prompted Query display. From this display, you can once 
again select definition steps of the query to create or change (as described in step 9) if you require. 
The parts of the query that you have defined are indicated by a “>” sign, shown to the left of the 
definition steps. 


If you want to leave one of the displays and return directly to the Define Prompted Query display, 
press F12 (Cancel) instead of the Enter key. 


6. To display the SQL SELECT statement that you are building through these prompted displays, press 
F18 (Display SQL). The SQL statement is shown with descriptive comments that tell you what function 
each part of the statement performs. You can find a description of the different parts of the SQL 
SELECTstatement on page dl 


7. If you wanted to change the long column names to system names, you would: 

a. Press F19 to display the system names. 

b. Press Enter to update your query and change the names in the query to the displayed names. 
8. If you wanted to change the system names to long column names, you would: 

a. Press F19 to display the long column names. 

b. Press Enter to update your query and change the names in the query to the displayed names. 


To run the query, press F5 (Run report) or F6 (Run sample). See page Kal for instructions. 


9. When you finish creating the query, press F3 (Exit) from the Define Prompted Query display to go to 
the Exit display. Enter a name and description for the query through this display. (Query naming 
conventions are described on page 29.) The description can be a maximum of 50 characters in length. 
If the query is already named, you can change the name if you desire. 


Select option 1 to save the query; then press the Enter_key to return to the Work with Query Manager 
Queries display. The Exit display is described on page hod 


lf you want to work through 


Appendix A a e exe 


practice exercises in which you create and work with a prompted query, turn to 
= O 
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Choosing the tables to include in the query in Query Manager 


If you choose to specify tables from the Define Prompted Query display (see page B4), Query Manager 
shows the Specify Tables display. An example of this display is shown in Figure 38 Use this display to 
enter the names of the tables that you want to query. 


Note: When you create a prompted query, you need to specify tables before you can define any of the 
other parts of the query. 


1G a. 
Specify Tables 


Type choices, press Enter. 


NSE! Somes een aes Bialp shite A STAFF. Name, F4 for list 
ColMecttionis vunrsse nce MYCOLL Name 


+ for more tables 


Bottom 
F3=Exit F4=Prompt F5=Run report F6=Run sample  F12=Cancel 
ee ey SQL  F20=Display entire name F22=QM Statement 


Figure 38. Specify Tables Display 


Enter the following information to specify the tables for the query: 

* Table. Type the name of the existing table that you want to query. You can press F4 (Prompt) to display 
a list of all tables in the current collection from which ou mall HEL a_selection. For information on long 
table names, see 


Query Manager assigns an identifier for each table selected by the query. In Figure 38] the identifier is 
“A”. Use the identifiers each time you refer to a table or column within the query definition. You cannot 
change this value. 

* Collection. Type the name of the collection (or library) in which the table resides. The default library is 
*LIBL. 

* + for more tables. Type “+” if you want the query to select more than one table. When you type “+ 
and press the Enter key, Query Manager displays additional pomp that ask rl to enter the name of 


wy ” 


the table and the collection in which it resides, as shown in 


To remove a table from the query definition, type blank spaces over the table and collection names. You 
can also replace a table selection by typing new names over existing table and collection names. When 
you remove or replace a specified table, Query Manager automatically removes most references to that 
table from the query definition. The only references that you need to remove manually are those that occur 
in expressions. See ge 90) for more information. 
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Specify Tables 
Type choices, press Enter. 


Table? sat we se A STAFF. Name, F4 for list 
Collection: -. 4 os ee es MYCOLL Name 


+ for more tables 


Figure 39. Specify Tables Display 


You can select from 1 to 32 tables through the Specify Tables display. “A” and “B” are identifiers that you 
use to refer to each table within the query definition. These identifiers also reflect the order in which the 
tables are selected by the query. The identifier order goes: A, B, C, ... Z, AA, BB, CC, and so on to FF. 


Specifying join conditions in Query Manager 

If you specify more than one table, when you press the Enter key, Query Manager shows the Specify Join 
Conditions display. Use this display to define the rules by which the tables should be joined. An example 
of the Specify Join Conditions display is shown in Figura 4d 


ee 
Specify Join Conditions 
Type comparisons to show how table selections are related, press Enter. 
Tests: =, <>, <=, >=, <, >, EQ, NE, LE, GE, LT, GT 
Column Test Column 
A. DEPT. = B.DEPTNO 
More... 
Data 
Table Column Type Width 
STAFF A.ID INTEGER 
A.NAME CHARACTER 9 
A.DEPT INTEGER 
A.JOB CHARACTER 5 
A.YEARS INTEGER 
More... 
F3=Exit F4=Prompt F5=Run report F6=Run sample  F11=Display description 
F12=Cancel F18=Display SQL  F22=QM statement F24=More keys 
yy 
; > 
F19=Display column names F20=Display entire name ey, 


Figure 40. Specify Join Conditions Display 


All tables must have a connecting column, so that Query Manager can link from one table to the 
corresponding rows in another table. This is done by linking the rows with matching values in the linking 
columns. 


shows the results of joining the A.RESIDENCE table to the B.PHONELIST table, for 
all rows where A.NBR = B.NBR. 
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RESIDENCE Table (Table A) PHONELIST Table (Table B) 


NBR NAME ADDR NBR NAME PHONE 

1 Ruth A Anderson 22 W 2nd St 1 Ruth A Anderson 744-1017 
3 Jane L Johnson 123 Park Dr 3. Jane L Johnson 327-1234 
4 Susan M Jones Box 333 Rt l 4 Susan M Jones 744-9922 
4 Richard A Klein 978 N 9th Av 4 Richard A Klein 744-9988 
5 James A Kryka 421 S Ist Av 5 James A Kryka 327-1547 
6 6 Sam K Smith 16 N Broadway 


Joined Table i (Table AB) 


NBR NAME ADDR PHONE 

Ruth A Anderson 22 W 2nd St 744-1017 
Jane L Johnson 123 Park Dr 327-1234 
Susan M Jones Box 333 Rt 1 744-9922 
Richard A Klein 978 N 9th Av 744-9988 
James A Kryka 421 S 1st Av 327-1547 


oP FP wre Ww 
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Figure 41. Example of Joined Tables 


Use the top part of the Specify Join Conditions display to specify the conditions that you want Query 
Manager to use when it joins the tables. The bottom part of this display lists all of the columns in the 
selected tables. Enter the following information to specify join conditions: 


* Column. Enter the name of the column (including the table identifier prefix) from the first table for which 
you want to specify the condition (for example, A.DEPT in . The names of all of 
the columns you can choose are listed at the bottom of the display. 


* Test. Enter the test condition you want to use to compare the two column values. Choose from the 
following conditions: 


Table 4. Prompted Query Test Conditions for Joining Tables 


Test Description 

EQ, = Equal to. The columns must match exactly. 

NE, <> Not equal to. The columns must not match. 

LE, <= Less than or equal to. Column 1 must have a value less 
than or equal to Column 2. 

GE, >= Greater than or equal to. Column 1 must have a value 
greater than or equal to Column 2. 

LT, < Less than. Column 1 must have a value less than 
Column 2. 

GT, < Greater than. Column 1 must have a value greater than 
Column 2. 


* Column. Enter the name of the column (including the table identifier prefix) from the second table 
against which you want to make the comparison (for example, B.DEPTNO in 
The names of all of the columns you can choose are listed at the bottom of the display. 


Query Manager joins the tables after performing column-by-column comparisons. If you specify more than 
one condition, the conditions are joined by an AND connector. That means that only those rows where 
both conditions are true are selected by the query. 


Rules for joining tables in Query Manager 
When you specify join conditions, the following rules and guidelines apply: 


¢ All of the tables that you chose through the Specify Table Selections display need to be involved in at 
least one join. 
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* For two tables to be joined, they need to have at least one column in common. (Note that having a 
column in common does not mean that the column names are the same.) 

* The two columns you specify for the join need to have different table identifier prefixes, and the columns 
need to contain similar data, with compatible data types and lengths. The data types and lengths for all 


columns are listed at the bottom of the display. 


You can use F11 (Display description/Display column only/Display Type) to change the information 
shown at the bottom of the display. 


* Joins need to be linear rather than circular in nature. The following examples assume that you have 


selected four tables: A, B, C, and D. 


Join Conditions: A.DEPT = B.DEPTNO 
B.STAFF = C.EMPS 
C.MGR = D.MANAGER 
Table A Table B Table C Table D 
Join Conditions: A.DEPT = B.DEPTNO 
B.STAFF = C.EMPS 
B.BOSS = D.MANAGER 
Table A Table B Table C 
Table D 
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Figure 42. Examples of Linear (Valid) Table Joins 


shows valid join conditions for these tables. 


igure 43 on page 90) shows incorrect join conditions for the tables. Notice how these joins are circular 


in nature. 
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Join Conditions: A.DEPT = B.DEPTNO 
A.JOB = (C.JOB 
C.MGR = D.MANAGER 
B.STAFF = D.STAFF 


Table A Table B 


Table C Table D 


Join Conditions: A.DEPT = B.DEPTNO 
B.STAFF = C.EMPS 
B.BOSS = D.MANAGER 
A. JOB = D.JOBCODE 


Table A Table B -— Table C 


= Table D 


Figure 43. Examples of Circular (Not Valid) Table Joins 
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When you are joining more than three tables, you might find it helpful to draw an example of the way in 
which you want the tables to be joined. By doing this, you can make sure that you are not joining the 
tables in a circular manner. 


* All of the tables need to be joined in a single join sequence. In [Figure 44, all of the tables are involved 
in at least one join, but the joins are not connected in a single sequence. 


Join Conditions: A.DEPT = B.DEPTNO 
C.MGR = D.MANAGER 
Table A Table B Table C Table D 
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Figure 44. Example of an Incomplete Table Join 


° 8 shows ways in which the four tables can be joined to make a single join 
sequence. As a rule, the number of join conditions you specify should be one less than the number of 
tables selected, so when you select four tables, you should specify three join conditions. 


Defining expressions in Query Manager 


If you choose to define expressions from the Define Prompted Query display (see page , Quer 
anaes shows the Define Expressions display. An example of this display is shown in 
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Define Expressions 
Type expression using column names, constants, and operators, press Enter. 
For full name and expression, press F4. 
Valid operators are: +, -, *, /, CONCAT ... 
Name Expression 
TOTAL_PAY. SALARY+COMM 
More... 
Column Column Column 
A.ID A.COMM 
A.NAME B.DEPTNUMB 
A.DEPT B.DEPTNAME 
A.JOB B.MANAGER 
A.YEARS B.DIVISION 
A.SALARY B. LOCATION 
Bottom 
F3=Exit F5=Run report F6=Run sample’ Fll=Display type  F12=Cancel 
F18=Display SQL F19=Display column names F24=More keys ) 
=~ 
F20=Display entire name F22=QM Statement F24=More keys y 


Figure 45. Define Expressions Display 


Using this display, you can create new columns and row values to use with the query and include in query 
output. You can also give names to the expressions you define. Each expression you define creates a new 
column of query data. The column values are the result of the expression. The column name used in the 
prompted query definition will either be the expression name if it is named or the expression itself. For 
example, (A.SALARY+A.COMM) / 12 in Fouad If the expression you want to enter is longer than the 
length of the prompt line, press the F4 (Prompt) key. This will bring up a different Define Expressions 
panel that will allow you to enter the entire name. F4 allows you to enter the full name as well as the full 
expression. F20 (Display entire name) can also be used to enter the longer name. If the expression is 
more than 54 characters in length, it is truncated when it is shown on the Select and Sequence Columns 
display and a “...” suffix is added: for example, (A.SALARY+A.COMM)... 


To name the expressions you define, place the cursor on the Name input area and enter the name you 
want. When naming expressions, observe the following rules: 


* Do not use column names from the list on the lower half of the display or the names of other 
expressions. 


* If you need to enter a name longer than the length of the prompt line, press the F4 (Prompt) key. You 
will see another Define Expressions panel that will allow you to enter the full name and the full 
expression. F20 (Display entire name) can also be used to enter the long name. 


¢ Start the name with an alphabetic character (A through Z, $, #, or @). Up to 29 alphanumeric 
characters (A through Z, 0 through 9, $, #, @ or _) may be used for the remainder of the name. Do not 
use blanks within the name, unless the entire name is blank. 


The column heading is the expression name if it is named. Expression names can also be quoted, in 
which case any character greater than X’3F’ and less than X’FF’ is allowed within the quotes. If the actual 
expression is more than 20 characters in length, the phrase describing the expression will be used. If you 
would like to define different column headings, you can create a report form from the define Prompted 
Query menu and personalize your column headings. 


The column heading used for report form definitions and printed reports will either be the expression itself 
with blanks added to improve readability or it will be a phrase describing the expression. If the edited 
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expression is more than 20 characters in length, the phrase describing the expression will be used. The 
column name used will be the characters "SEL” followed by a unique number, SEL1 for the first 
expression, SEL2 for the second expression and so on. The number used depends on how the expression 
is sequenced with respect to other expressions, summary functions and duplicate columns on the ’Select 
and sequence columns’ display. When you define expressions, it is a good idea to keep a note of which 
expression each one of the "SEL” column names refers to. 


Note that the only way that you can change column headings for printed and displayed reports is by 
creating a report form, or by defining a named expression. If you create a report form, the column name 
remains unchanged. If you define a named expression, the column name is renamed. See 

64 for instructions on how to create a report form. 


The expressions that you define through this display do not need to appear in your query output. You can 
define expressions to use as intermediate steps for obtaining final results. For example, you can define an 
expression to use when you select the rows to include in the query output, or to create a value for which 
you want to calculate summary data. Expressions are included in query output if you select them through 


the Select and Sequence Columns display. See 
prea ciensger an eae ad for more information. 


Enter the expression in free format. The expression can include column names (prefixed by the table 
identifier), constants, parentheses (to show operation priority), and any of the following arithmetic 
operators: 


Table 5. Arithmetic Operators 


Op Description 
2 Addition 

5 Subtraction 

7 Multiplication 
/ Division 


Use these operators with number values only. If the data types for all columns are not currently shown at 
the bottom of the display, press F11 (Display description). The result of any expression containing a null 
value is null. 


Including functions, durations, and special registers in expressions in Query 
Manager 

You can include functions, durations, and special registers in the expressions you create through the 
Define Expressions display. The supported functions, durations, and special registers include, but are not 
limited to, the following: 


* Functions: AVG, CHAR, COALESCE, CONCAT, COUNT, DECIMAL, DIGITS, FLOAT, HEX, INTEGER, 
LENGTH, MAX, MIN, STRIP, SUBSTR, SUM, TIME, TIMESTAMP, VALUE, VARCHAR, VARGRAPHIC 


* Durations: DATE, DAY, DAYS, HOUR, MICROSECOND, MINUTE, MONTH, SECOND, YEAR 


* Special Registers: CURRENT DATE, CURRENT_DATE, CURRENT TIME, CURRENT_TIME, 
CURRENT TIMESTAMP, CURRENT_TIMESTAMP, USER, CURRENT PATH, CURRENT SCHEMA 


You can find detailed descriptions of all of the functions, durations, and registers in the [SQL Referencd. 
CONCAT function considerations in Query Manager: Use the CONCAT (concatenation) function to 
join two values together. This function can be used only with alphanumeric values, and can join two 


columns, or a column and a constant. The result appears as one column in the report. 


If you want to include a column with a number data type in a concatenation string, you need to convert the 
numbers to alphanumeric values using the DIGITS function. The result of the concatenation is an 
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alphanumeric string with no decimal place. For example, the expression ('$' CONCAT DIGITS (A.SALARY) ) 
creates a column containing the SALARY values from table A prefixed with a dollar sign. The 

('$' CONCAT DIGITS(A.SALARY)) values are alphanumeric values, and cannot be used in arithmetic 
operations. 


Note that an alphanumeric constant needs to be enclosed in single quotation marks. For more information, 


Each expression you define is limited to the length of one input line shown on the Define Expressions 
display. This is due to one of Query Manager’s internal size limitations. You can use the CONCAT function 
to join two input lines and create a longer expression. 


VARCHAR and VARGRAPHIC functions and UCS2-graphic data in Query Manager: The VARCHAR 
function returns a character string in the default or a specified CCSID. You can use VARCHAR to convert 
UCS2-graphic data to a form that can be displayed or printed in a report. You can also use it to compare 
or concatenate UCS2-graphic data with SBCS or DBCS data. VARCHAR converts UCS2-graphic data to 
SBCS, DBCS-open, DBCS-only, or DBCS-either. The function does not convert UCS2-graphic data to bit 
data, CCSID 65535. 


The VARGRAPHIC function returns a graphic string representation of a string expression. You can use 
VARGRAPHIC to convert SBCS, DBCS-open, DBCS-only, or DBCS-either so it can be compared with or 
concatenated to UCS2-graphic data. VARGRAPHIC does not convert bit data (CCSID 65535). 


For complete details on the VARCHAR and VARGRAPHIC functions, see the Bobi ene book. For 
more information, see 


Selecting and sequencing columns from the tables in Query Manager 


If you choose to select and sequence columns from the Define Prompted Query display (see page 4), 
ae eae shows the Select and Sequence Columns display. An example of this display is shown in 


Chapter 5. Creating and changing queries in Query Manager 93 


(© > 


Select And Sequence Columns 


Type a sequence number (0-9999) for the name of each column to appear in the 
report, press Enter. 


n 


eq Column Seq Column 
TOTAL_PAY B.MANAGER 


DIVISION INFORMATION 7a: B.DIVISION 

MYCOLL.STAFF-- ALL en Soe B. LOCATION 
A.1D 

A.NAME 

A.DEPT 

A.JOB 

A. YEARS 

A. SALARY 
A.COMM 

MYCOLL.ORG-- ALL 
B.DEPTNUMB 
B.DEPTNAME 


a Ae Tee 


Bottom 
F3=Exit F5=Run report F6=Run sample  F10=Duplicate column 
Chea! type F12=Cancel F18=Display SQL F24=More keys 


a 


F19=Display column names F20=Display entire name F21=Select all 
F22=QM Statement  F24=More keys 


Figure 46. Select and Sequence Columns Display 


Use this display to choose the columns that you want the query to select, and to specify the sequence in 
which you want the columns to be selected. The sequence affects the order in which the columns are 
retrieved by the query, and the order in which the columns are shown in the resulting report. 


Note: If there is any unreadable text shown in the Description column on the display, it is probably due to 
a CCSID conversion error. A message at the bottom of the display will explain any errors that 
occurred. 


The Select and Sequence Columns display shows the following information: 

¢ All of the tables, and all columns from all of the tables you selected using the Specify Tables display 
(see page 

¢ All expressions you defined using the Define Expressions display (see page ka) 

¢ All summary functions you selected through the Select Summary Functions display (see page fod) 


Note: If any expression or summary function is more than 20 characters in length, Query Manager 
truncates it, and adds “...” to the end of the displayed expression or summary function to indicate 
that it has been truncated: for example, (A.SALARY+A.COMM)... 


Enter a number from 0 to 9999 in the Seq prompt next to the columns, expressions, and summary 
functions you want to select, to specify the sequence in which you want them to be selected by the query. 
0 is the lowest (first) sequence number, and 9999 is the highest (last). The default is for all items to be 
selected, and to be sequenced in the order in which they appear on the Select and Sequence Columns 
display. 


Every column for which you specify a sequence number is selected by the query. The following rules apply 
when specifying sequence numbers: 


¢ Sequence numbers do not need to be consecutive. 


* If you specify the same sequence number for more than one item, the items are selected in the same 
order as they appear on the Select and Sequence Columns display. For example: 
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A.ID 
A.NAME 
A.DEPT 
A.JOB 
A. YEARS 


rR Re 


would result in the following SELECT sequence: 
SELECT A.NAME, A.JOB, A.ID, A.YEARS, A.DEPT 
e Any items for which you do not specify a sequence number are not selected by the query. 


If you want to select all columns from a table, and have them sequenced in the same order as they 
appear in the table, type a sequence number in the Seq prompt next to the table name (for example, 
STAFF and ORG in Figura 48 nn page ad), The “-- ALL” that follows the table name tells Query Managerto 
select all columns from the table. 


When you press the Enter key, the columns are reordered on the display so that they are shown in the 
sequence you specified. Unselected columns appear at the end of the list. The columns may also be 
renumbered, so that the first selected column has a sequence number of 10, the second of 20, the third of 
30, and so on. Continuing the previous example, when you press the Enter key, the columns would be 
shown in the following order: 

10 A.NAME 

20 A.JOB 

30 A.ID 

40 A.YEARS 

50 A.DEPT 


Press the Enter key a second time to leave the Select and Sequence Columns display, and go to the next 
display you specified through the Define Prompted Query display. 


Note: If you do not choose to “Select and Sequence Columns”, the query selects all columns from all of 
the tables you specified. The columns are sequenced in the same order as they appear in the 
database tables. 


Including duplicate columns in Query Manager 

You can add a duplicate column, expression, or summary function to the Select and Sequence Columns 
display, and get the query to select it (and the report to display it) more than once. Simply position the 
cursor on the item that you want to copy; then press F10 (Duplicate column). The duplicate column, 
expression, or summary function is inserted immediately below the item the cursor was positioned on 
when you pressed F10. If a named expression is duplicated, the duplicated expression will be unnamed. 


Specifying row selection tests in Query Manager 


If you choose to select rows from the Define Prompted Query display (see page 84), Quer Manager 
shows the Select Rows display. An example of this display is shown in : 
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Select Rows 


Type new comparison test, press Enter. 


Column or expression. .... A. SALARY. 

TSA USNOM fos3 se: Sete ei we sas TS. 1S; c1SNOT 

IIa heme terrae aeriecrner caer aon EQS LTs, RES Gls. .GE ss. 
ViciliUGmersaeceneatstestecs saeccn es eeaecers 5000.00 


To change previous comparison test, position cursor on 
test and press Enter. 


Previous comparison tests 
If A.SALARY is greater than 5000.00 
And A.Name is not starting with 'SMIT' 


Bottom 
F3=Exit F4=Prompt F5=Run report F6=Run sample  F12=Cancel 
See SQL  F22=QM Statement 


Figure 47. Select Rows Display 


Use this display to specify the rows that you want to be retrieved by the query. You do this by defining 
comparison tests for the column values. Only those rows that match the tests you define are retrieved by 
the query. For example, if you want to select only those rows where the eva) is greater than $5,000, you 
would define the first test condition shown in the bottom half of 


If A.SALARY is greater than 5000.00 


You define a comparison test by answering all of the prompts shown on the display. Any comparison tests 
that you have already defined are shown in the bottom half of the Select Rows display. Each time you 
finish defining a new comparison test, it is added to the tests in the bottom half of the display. 


You can edit or delete a comparison test that already exists. Simply position the cursor on the test that you 
want to change or delete; then press the Enter key. The comparison test is marked by a “>” sign in the 
bottom half of the display, and the details of the test are shown as prompt values in the top half of the 
display. (Any values that had already been entered for the prompts in the top half of the display are 
replaced by the details of the selected comparison test.) Make the changes to the values that define the 
comparison test; then press the Enter key to save your changes. To delete the comparison test, blank out 
all of the values shown in the prompts before you press the Enter key. 


When changing a comparison test, it may be necessary to change the “Values” before you change the 
“Test”. The BT (Between) test must have two values specified, the NL (Null) test must have zero values. 
If you are changing a comparison test so that it has a “Test” of either BT or NL, you may first need to 
erase “Values” by typing blanks over the existing values. Query Manager displays an error message if you 
specify BT or NL when an incorrect number of “Values” exist. 


Enter the following information to define comparison tests: 


¢ AND/OR. You need to enter either AND or OR when you define more than one comparison test, to join 
the tests. Type AND if both the previous test and the current test need to be true for the row to be 
selected. Type OR if either the previous test or the current test need to be true for the row to be 
selected. The AND/OR connector is described in greater detail in 


¢ Column/Expression. Type the name of the column or expression on which you want the comparison 
test performed. Press F4 (Prompt) if you want Query Manager to display a list of all of the columns and 
expressions selected by the query. Choosing a column or expression from the F4 (Prompt) list is 
described in 
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* IS/ISNOT. Type IS if you want only those rows for which the test condition is true to be selected. Type 


ISNOT if you want only those rows for which the test condition is false to be pees The IS/ISNOT 


prompt is described in greater detail in 


* Test. Specify the test condition (for example, equal to, less than, scale with) that you want to use to 
perform the comparison. Press F4 (Prompt) if you want Query Manager to display a list of all of the test 


condition of BT ipcwvec the =aify window is oe el ) 


Note that you need to enter two values for a test condition of BT (Between), and zero values for a test 


condition of NL (Null). You can enter up to six values for all other test conditions. 
The test values you enter can be column names, expressions, or constants. 


Note: If you press F4 (Prompt) while you are creating a comparison test, a prompt window is displayed 
for the first prompt (shown on the Select Rows display) that you have not yet completed. For 
ressing F4 (Prompt) will 
) regardless of where the 
cursor is positioned. If you are changing a comparison test, pressing F4 (Prompt) will show the 
window that relates to the prompt where the cursor is currently positioned. 


example, if you have not entered any values for the comparison =F : 


show the Select Columns for Row Conditions window (shown in 


The row selection tests that you specify through this display create the WHERE clause of the SELECT 


statement. For a detailed explanation of the SELECT statement and the WHERE clause, refer to the sen 


Choosing columns for row selection test 


One of the first things you need to enter when you define comparison tests is the name of the column or 


expression against which you want the test performed. To display a list of all columns selected by and 


expressions defined for the query, press F4 (Prompt). An example of the list of columns and expressions 


is shown in 
= 
Select Rows 
Select Column for Row Conditions 
Connector .. AND, OR 
Type option, press Enter. : 
1=Select coug GEstee 
Opt Column 
STAFF -- ALL 
A.1D 
A.NAME 
A.DEPT 
A.JOB 
More... 
F12=Cancel F19=Display column names 
F20=Display entire name 
Srevewste lst sicuarsMerecenete auers cnvieloteiotevetana score vers taveietotstelereisusceceietnioreretevers Bottom 
F3=Exit F4=Prompt F5=Run report  F6=Run ale F12=Cancel 
F18=Display SQL F22=QM Statement 
a 
Figure 48. Select Columns for Row Conditions Window 
Enter the following information through this window: 
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* Connector. Select either AND or OR when more than one comparison test has been defined, to join the 
tests. The default connector is AND. 


Type AND if two or more of the comparison tests need to be true for a row to be selected. For example, 
to select the rows for all clerks who have been employed for more than 7 years, you join the tests using 
AND. 


If A.JOB is equal to 'Clerk' 
And A.YEARS is greater than 7 


Type OR if only one of the comparison tests need to be true for a row to be selected. For example, to 
select the rows for all managers, and for all staff who earn more than $10,000, you join the tests using 
OR. 


If A.JOB is equal to 'Mgr' 
Or A.SALARY is greater than 10000 


Note: You are prompted to enter an AND/OR connector only when at least one other comparison test 
already exists. The prompt for the connector is not shown when you define the first comparison 
test. 


¢ Column/Expression. Choose one of the columns or expressions from the list by typing 1 in the Opt 
prompt next to the name of the column or expression on which you want the selection test performed. 


When you see More... displayed in the lower right-hand corner of the window, you can use your display 
station’s roll keys to view the rest of the columns and expressions selected by the query. When you 
come to the end of the list, Bottom is displayed instead of More... 


Choosing test conditions for row selection test 

After you select the column or expression on which you want the comparison test performed, you need to 
specify the type of test that you want performed on the row data. To display a list of all the supported test 
operators, press F4 (Prompt). An example of the list of test operators is shown in 


a > 


Select Rows 


Select Comparison Test 


Test qualifier IS IS, ISNOT 


Type option, press Enter. 


1=Select 2 Geom G Breese 
Opt Test Description 
EQ Equal to 
GT Greater than 
GE Greater than or eq 
LT Less than 
LE Less than or equal 
BT Between 
More... 
F12=Cancel 
slate cue aconersteierevevstorsenevecoueletals aisieiore cuatetteretolctessveatereveusraterenate caterers Bottom 
F3=Exit F4=Prompt F5=Run report F6=Run sample  F12=Cancel 


ee ey SQL  F22=QM Statement 


Figure 49. Select Comparison Test Window 


Enter the following information through this window: 


¢ Test qualifier. Choose IS if you want the query to select only those rows for which the comparison test 
is true. Choose ISNOT if you want the query to select only those rows for which the comparison test is 
false. The default qualifier is IS. 
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* Test operator. Choose one of the test operators from the list by typing a 1 in the Opt prompt next to the 
description of the test operator you want to use in the selection test. The available test operators are 
described in 
When you see More... displayed in the lower right-hand corner of the Select Comparison Test window, 
you can use your display station’s roll keys to view the rest of the available test operators. When you 
come to the end of the list, Bottom is displayed instead of More... 


Table 6. Select Rows Test Operators for Prompted Query 


Test Description 

EQ Equal to—exact match 

LT Less than 

LE Less than or equal to 

GT Greater than 

GE Greater than or equal to 

BT Between—between two specified values 

SW Starting with—first character(s) matches specified value. 


For example, brain, branch, and break all start with ‘br’. 


EW Ending with—last character(s) matches specified value. 
For example, branch, lunch, and Jurch all end with ‘ch’. 


CT Contains—any character(s) matches specified value. For 
example, brain, branch, and Junch all contain ‘n’. 


NL Null—column contains a NULL value 


Specifying test values for row selection test 

After you select the column or expression on which you want the comparison test performed, and the type 
of test that you want performed on the row data, you need to enter test values to complete the comparison 
test. To enter more than one test value, press F4 (Prompt). Query Manager shows a Specify Comparison 


Test Value_window, through which you enter multiple comparison test values. An example of this window is 
shown in Figure 50 on aE 100) 
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Select Rows 


Specify Comparison Test Value 


Type the value, expression, or column for comparison, press Enter. 
If A.SALARY is equal to 


OR 


OR 


More... 
F12=Cancel F19=Display column names F2Q=Display entire name 


And A.NAME is not starting with 'SMIT' 


Bottom 
F3=Exit F4=Prompt F5=Run report F6=Run sample  F12=Cancel 
Secunda! SQL  F22=QM statement 


Figure 50. Specify Comparison Test Value Window 


The Specify Comparison Test Value window displayed differs depending on the test operator that you 
chose: 


* If you chose a test operator other than BT (Between) or NL (Null), Query Manager shows a window 
similar to the one shown in Figure 50, You can enter up to six test values through this window. All 
values are joined with the OR connector. 

* If you chose a test operator of BT (Between), the Specify Comparison Test Value window prompts you 
to enter two values only. These two values are joined with the AND connector. 


* If you chose a test operator of NL (Null), no Specify Comparison Test Value window is shown. It is not 
valid to specify test values for the NL test operator. 


The test values you enter can be constants, expressions, or other column names. 


Constants for character, date, and time data types need to be enclosed in single quotation marks, and you 
need to double any quotation marks that you want to include in the value: for example, '0'Brien' or 
'10/10/92'. Query Manager recognizes uppercase and lowercase letters, and searches for the value 
exactly as you type it. 


Constants for graphic data types need to begin with G or g, be enclosed in single quotation marks, and be 
delimited by shift-out and shift-in characters. The following examples use “<” to indicate the shift-out 
character, and “>” to indicate the shift-in character: G'<A B C >' or g'<DEF>'. 


Query Manager validates each comparison test before saving it. If the value you enter does not match the 
column’s data type, or if you enter a value when the test operator is NL (Null), an error message is shown 
and the comparison test is not saved. 


Specifying sort conditions for columns in Query Manager 


If you choose to select sort columns from the Define Prompted Query display (See page EY , Quer 
ait shows the Select Sort Columns display. An example of this display is shown in air 54 a 
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Select Sort Columns 


Type a sort priority (0-9999) and A (Ascending) or D (Descending) for the 
names of up to 32 columns, press Enter. 


Sort Sort 

Prty A/D Column Prty A/D Column 
TOTAL_PAY pee B.DIVISION 
DIVISION_INFORMATION ae B.LOCATION 
(A.SALARY + A.COMM) 

ID 

NAME 

DEPT 

JOB 

YEARS 

SALARY 

COMM 

DEPTNUMB 

DEPTNAME 

.MANAGER 


Ce eee 


Wowrrrrrr,yp 


Bottom 
F3=Exit F5=Run report F6=Run sample’ Fll=Display type  F12=Cancel 
F18=Display SQL F19=Display column names F24=More keys 


Vay 


(_r20-0ispiay entire name F22=QM Statement F24=More keys 


Figure 51. Select Sort Columns Display 


Use this display to determine the order in which the data retrieved by the query should be sorted. Choose 
the columns to be sorted, and specify whether the sort should be in an ascending or descending order. If 

you choose to sort more than one column, you also need to specify the priorities of the different columns 

being sorted. 


The Select Sort Columns display shows the following information for you to sort: 

* All columns you selected using the Select and Sequence Columns display (see page 93) 

¢ All expressions you defined using the Define Expressions display (See page 

¢ All summary functions you selected through the Select Summary Functions display (see page Lod) 


Enter the following information to select the sort conditions for the query: 


¢ Sort Prty. Enter a number from 0 to 999 to specify the priority of the columns, expressions, and 
summary functions being sorted, where 0 has the highest priority and 999 has the lowest. For example, 
in Figura Sl A.DEPT has a sort priority of 1, and A.JOB has a sort priority of 2. This means that the 
query data is sorted by DEPT number, and within each DEPT, the data is sorted by JOB. If you specify 
the same sort priority for more than one item, the items are sorted in the same order as they appear on 
the Select Sort Columns display. 


Note: The total width of all of the columns that you select to sort cannot exceed 10,000 characters. You 
can view the widths of the individual columns by pressing F11 (Display description). 


¢ A/D. Type A if you want the values sorted in ascending order (lowest to highest), or type D if you want 
the values sorted in descending order (highest to lowest). When you sort alphanumeric values in 
ascending order, Query Manager uses the following sort sequence: 


1. Special characters, including blanks, come first 
Lowercase letters in alphabetic order 
Uppercase letters in alphabetic order 

Numbers in ascending order 

NULL values come last. 


of oN 
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Date and time data types are sorted in chronological order. 


The sort sequence that you specify through this display determines the ORDER BY clause of the SELECT 
statement. For a detailed explanation of the SELECT statement and ORDER BY clause, refer to the 


Defining summary functions in Query Manager 


If you choose to select summary functions from the Define Prompted Query display (see page the 
program shows the Select Summary Functions display. An example of this display is shown in 


VE > 
Select Summary Functions 
Type options, press Enter. 
1=Select 
Data 

Sum Avg Min Max Cnt Column Type Width 
TOTAL_PAY DECIMAL 
DIVISION_INFORMATION VARCHAR 
TOTAL_PAY/12 DECIMAL 
A.DEPT SMALLINT 4 
A. JOB OPEN 5 
A.ID SMALLINT 4 
A.NAME OPEN 9 
A.YEARS SMALLINT 4 
A.SALARY DECIMAL 8 
A.COMM NUMERIC 6 
A.DEPTNUMB DECIMAL 2 
A.DEPTNAME CHARACTER 15 
A.MANAGER DECIMAL 3 

More... 
F3=Exit F5=Run report F6=Run sample F10=Define expression 
eb ieuley description F12=Cancel F18=Display SQL F24=More keys ) 


Figure 52. Select Summary Functions Display 


Use this display to specify the summary functions that you want to perform on the query data. Each 
summary function you specify creates a new column of query data. The column values are the result of 
the summary function. The column name is the summary function itself: for example, SUM(A.SALARY). 


All of the columns selected by, and expressions defined for, the query are shown on the Select Summary 
Functions display. Type 1 in the prompts beside the column and expression names to specify the summary 
functions you want to perform. You can specify more than one summary function to be performed for a 
single column or expression. 


[Table 7| describes the available summary functions. In this table, “A. COLUMN” is used to indicate the column 
or expression for which you specify the summary function. 


Table 7. Select Summary Functions for Prompted Query 


Function Description 

SUM The sum (total) of the values in the column. 
Generates SELECT SUM(A.COLUMN) ... 

AVG (AVERAGE) The average of the values in the column. 
Generates SELECT AVG(A.COLUMN) ... 
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Table 7. Select Summary Functions for Prompted Query (continued) 


Function Description 

MIN (MINIMUM) The minimum value in the column. 
Generates SELECT MIN(A.COLUMN) ... 

MAX (MAXIMUM) The maximum value in the column. 
Generates SELECT MAX(A.COLUMN) ... 

CNT (COUNT) The number of values in the column, including repeated 
values and null values. Generates SELECT COUNT(*) ... 


Note: The COUNT summary function for prompted queries is not the same as the COUNT column usage 
for report formatting. Null values are included in the total when the COUNT summary function is 
specified through a prompted query. Null values are not included in the total when the COUNT 
column usage is specified through report formatting. 


If you want to create a new expression to include in the list of columns retrieved by the query, press 

F10 (Define expression) to go to the Define Expressions display (as shown in Pome cee ai). Use 
this display to create expressions for which you can select summary functions. When you finish creating 
expressions, press the Enter key to return to the Select Summary Functions display. See 


The summary functions that you specify through this display do not necessarily appear in your query 
output. To ensure that the summary function does appear in the query output, you should select the 


Note that, like expressions, you can define summary functions to use as intermediate steps for obtaining 
final results. 


Note: When you select summary functions, Query Manager adds a GROUP BY clause to the SELECT 
statement. The GROUP BY clause contains all of the column names in the select list, and all of the 
column names used in expressions in the select list. The columns are listed_in the sequence that 
you specify through the Select and Sequence Columns display (see page 93! for more information). 
For a detailed explanation of the SELECT statement and the GROUP BY clause, refer to th 


Choosing to include duplicate rows in Query Manager 


If you choose to specify duplicate rows from the Define Prompted Query display (see page Quer 
Manader shows the Specify Duplicate Rows display. An example of this display is shown in palo 5 on 
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( > 
Specify Duplicate Rows 


Type option, press Enter. 
If duplicate rows exist in the data 


Duplicate option... 1 l=Keep duplicate rows 
2=Keep only first copy of each row 


F3=Exit F12=Cancel 


Figure 53. Specify Duplicate Rows Display 


Use this display to specify whether you want to include duplicate rows in the data retrieved by the query. 
The default is to keep the duplicate rows. 


Note: If you press the Enter key after taking the default, the ">” will not appear on the Define Prompted 
Query display. 


If you do not want to include duplicate rows in the data retrieved by the query, select option 2 (Keep only 
first copy of each row). Query Manager checks all rows retrieved by the query. When two rows match 
exactly (that is, when every value in the first row matches every value in the second row), only one of the 
rows is included in the report. 


Specifying a sort sequence in Query Manager 


The Show query sort sequence options option in your Query Manager profile must be set to YES before 
you can specify a sort sequence. The Specify sort sequence option does not appear in the Define 
Prompted Query display if the profile option is set to NO. 


If you choose to specify a sort sequence from the Define Prompted Query display (see page [pd)), or press 


F18 (Sort sequence) on the Edit Query display (see page [zd Query Manager shows the Specify Sort 
Sequence display. An example of this display is shown in San eeRPETE| 
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Specify Sort Sequence 
Type choices, press Enter. 


Sort sequence. ...... 1 1=*JOBRUN 
2=*LANGIDSHR 
3=*LANGIDUNQ 
4=*HEX 
5=Sort sequence table 


Language identifier... .  *JOBRUN Name, *JOBRUN, F4 for list 


F3=Exit F5=Run report F6=Run sample  F12=Cancel 
F1l7=Job sequence F18=Display SQL F22=QM statement y 


Figure 54. Specify Sort Sequence Display 


If you have never specified sort sequence information for the query, this display shows the sort sequence 
and language identifier, both set to *JOBRUN (the defaults). 


You can press F17 (Job sequence) to refresh the display with the values from the SRTSEQ and LANGID 
keywords from your job. If the SRTSEQ value is a sort sequence table, the table input display is shown. 

Press the Enter key to put the refreshed values into effect. 

The options for sort sequence and their meanings are: 

*JOBRUN The program uses the value from the SRTSEQ keyword in the job when the query runs. 


*LANGIDSHR The program uses the sort sequence that has shared collating weights. With this sort 
sequence, uppercase and lowercase characters have equal collating weight. 


*LANGIDUNQ The program uses the sort sequence that has unique collating weights for each character. 
With this sort sequence, uppercase and lowercase characters have different collating 
weights. 


*HEX The program uses the hexadecimal value of each character for sorting. 


Sort sequence table 
The program uses a specific sort sequence table. When you select this option, the Specify 


Sort Sequence display is refreshed with prompts for sort sequence table information, as 
shown in Figure 7 = page 106) 
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(E ~ 
Specify Sort Sequence 


Type choices, press Enter. 


Sort sequence ....... 5 1=*JOBRUN 
2=*LANGIDSHR 
3=*LANGIDUNQ 
4=*HEX 
5=Sort sequence table 


Language identifier... . *JOBRUN Name, *JOBRUN, F4 for list 
For sort sequence 5=Sort sequence table 
Sort sequence table .... Name, F4 for list 
iD Raye eeecesverccadeeveres pene: Name, *LIBL, *CURLIB 


F3=Exit F5=Run report F6=Run sample  F12=Cancel 
F17=Job sequence F18=Display SQL F22=QM statement 
Salis table name and library or press F4 for list. 


Figure 55. Specify Sort Sequence Display 


The options for Language identifier and their meanings are: 


*JOBRUN 
The program uses the value from the LANGID keyword in the job when the query runs. 


Name _ The three-character language identifier. Press F4 for a list of the supported languages and their 
identifiers. 


You may leave the language identifier blank if you select options 4 (*HEX) or 5 (Sort sequence table). The 
program sets the LANGID value stored with the query to *JOBRUN. When you return to this display, the 
language identifier is filled in. 


Defining a report form in Query Manager 


If you choose to specify report formatting from the Define Prompted Query display (see page Que 
ETE shows the Specify Report Formatting display. An example of this display is shown in 
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Specify Report Formatting 


Type choices, press Enter. 


Report<forms: ws tse es ee, er Name, F4 for list 
[aIDRAR Viren ashore cn site tea *LIBL Name, *LIBL 


F3=Exit F4=Prompt  F12=Cancel 


Figure 56. Specify Report Formatting Display 


Specify the name of the report form that you want to create or change, and the library in which it resides; 
then press the Enter key to go to the Select Report Format display. To view a list of all report forms in the 
current library, position the cursor on the prompt for “Report form” and press F4 (Prompt). 


When you create a report form as part of a prompted query definition, Query Manager extracts information 
from the query definition to insert as default values in the Edit Column Formatting display. These default 
values make it faster and easier for you to complete the information on this display. The following default 
values are loaded from the query definition: 


* The columns selected by the query are inserted as default column names and headings. 
* Columns are sequenced in the same order as they are selected by the query. 


If the report form you choose is not the active form, and if the active form has been edited since it was last 
saved, pressing the Enter key takes you to the Exit display. You need to specify whether you want_to save 
the changes made to the active form before you can go to the Select Report Format display. See 


Saving a query: Using the exit display in Query Manager 


The Exit display is used to save queries and report forms. 


When you finish creating or changing a query through the Edit Query or Define Prompted Query display, 
press F3 (Exit) to go to the Exit display. Using the Exit display, you can specify a new name for a query, 
enter a description of the query (up to a maximum of 50 characters), and specify the library in which you 
want the query saved. Query naming conventions are described on page ba 


The Exit display prompts you with the following options: 
1=Save and exit 
2=Exit without save 
3=Resume without save 
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4=Save and resume 


If you want to return to the “Work with” display, select option 1 to save the query, or option 2 to discard the 
changes you made to the query. If you want to return to the query editor and continue editing where you 
left off, select option 3 to return without saving the query, or option 4 to save the changes you made to the 


query. 


An example of the Exit display is shown in Figure 57. 


r ~ 


Exit 
Type choices, press Enter. 


ODEON 2 es oe 2 1=Save and exit 
2=Exit without save 
3=Resume without save 
4=Save and resume 


Query: se is eae ae MYQUERY__ Name 
Library: 3. MYCOLL Name, *CURLIB 
Description .. Select from staff where dept > 10 
F5=Refresh  F12=Cancel 
Ng yy 


Figure 57. Exit Display 


Note that you use the Exit display to save both queries and report forms. If you press F3 (Exit) from the 
Select Report Format display, you go to an Exit display, through which you can save the created or 
changed report form. Use this Exit display in the same way as described for queries. 


If you created or changed both a query and a report form during the current session, neither of which have 
yet been saved, the Exit display prompts you to confirm the details of both the query and report form (as 


shown in Figure 52). 


When you save a query or report form, you can create a new object, or replace an existing one. When a 
query or report form already exists with the same name and library that you specified in the Exit display, 
Query Manager shows a message warning you that by saving the query or report form you will replace an 
existing object. If you intended to replace the object, press the Enter key; otherwise, type a different name 
or library for the query or report form. 


You can also save a query by typing the SAVE QUERY AS statement on the Query Manager statement 
line (see page , and you can save a report form by typing the SAVE FORM AS statement on the 
Query Manager statement line (see page Beth 
Whenever you create or change a query or report form, Query Manager always prompts you to save the 
query or report form before performing any action that would replace or cancel it. 


Note: The Exit display is the only place where you can change the description of a query or report form. 


This description is shown on the “Work with” displays, to provide additional information about 
queries and report forms. A description can be a maximum of 50 characters in length. 
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Date and time format considerations while saving a query in Query 
Manager 


When you save a query, it is saved with the date and time format from your current job. If you change the 
date and time format of your job, it has no effect on existing queries. The existing queries still use the date 
and time format with which they were saved. 


When you select to work with a query, Query Manager checks to see whether the date and time formats 
match. You are always warned when the formats are different: 


* If you choose to change a query that was saved with a date and time format that is different from the 
date and time format of your current job, a message warns you that the formats are different. 


* If you choose to run a query that contains global variables and was saved with a date and time format 
that is different from the date and time format of your current job, a display warns you that the formats 
are different, and asks if you want to continue running the query. See page 


Changing a query in Query Manager 


You change queries in the mode in which they were last saved: either SQL or prompted. When you save 
the changed query, you can replace the original query definition with the edited definition, or you can save 
the edited definition as a new query and leave the original query unchanged. 


1. Type 1 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Queries display. 


2. Type 2 in the Opt prompt next to the names of the queries you want to change; then press the Enter 
key. The query editor display is shown, containing the first query you specified. Query editor displays 
for the remaining queries are shown in the same order as the query names appear in the “Work with” 
display list. 

* lf the query you choose to change is an SQL query, the SQL statement that defines the query is 
shown in an Edit Query display. 


¢ If the query you choose to change is a prompted query, the definition of the query is shown in the 
Define Prompted Query displays. 


Note: If “Allow change query creation mode” is set to NO in your Query Manager profile, you can 
change only those queries that are the same type (either SQL or prompted) as your “Default 
query creation mode”. Your “Query creation mode” and the “Type” for each query are shown on 
the Work with Query Manager Queries display. 


3. Change the , using the editor in the same way as auen ou create a query. Turn to Creating anl 
eo. O 


Note that when you change a prompted query, the parts of the query that have already been defined 


“S ” 


are indicated by a “>” sign, shown to the left of the definition steps. 


4. When you finish changing the query, press F3 (Exit) to leave the query editor and go to the Exit 
display. You can save the query under its original name to replace the existing query, or you can enter 
a new name for the query, to create_a new query and leave the existing one unchanged. Naming 
conventions are described on page bd. Using the Exit display and saving the query are described on 


page 


Note: If the query you change was saved with a date and time format that differs from that of your current 
job, Query Manager displays a message warning you that the formats are different. This is 
important if a date or time value is used in a conditional test for a WHERE clause. You might need 
to change either your query or the date and time format of your job. Position the cursor on the 
warning message; then press F1 (Help) for more information. 
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Converting a prompted query to SQL in Query Manager 


You can convert a prompted query to SQL when you want to take advantage of the additional SQL 
functions that the prompted creation mode does not support. 


When you choose to convert a prompted query to SQL, you can replace the prompted query definition with 
the definition of the newly converted SQL query, or you can give the SQL query a new name, and leave 
the promptedquery definition unchanged. 


Note: If “Allow change query creation mode” is set to NO in your Query Manager profile and your “Default 


query creation mode” is prompted, this option is not available through the Work with Query 
Manager Queries display. You cannot convert a query if you do not have authority to use the 
SELECT statement. 
Type 1 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Queries display. 
Type 10 in the Opt prompt next to the names of the prompted queries that you want to convert to SQL; 
then press the Enter key to go to the Convert Prompted Query to SQL Query display. This display lists 
the names of all of the queries you specified. An example of the Convert Prompted Query to SQL 
Query display is shown in Eiguza 5d 


Convert Prompted Query to SQL Query 


Leiibrarye ane sty ves suhav ee eet ce MYLIB 
To name a new SQL query, type new SQL query name, press Enter. 


Prompted Query SQL Query 
MYQUERY MYQUERY. 


Bottom 


F3=Exit F5=Refresh  F12=Cancel F22=QM statement 
NS ou 


Figure 58. Convert Prompted Query to SQL Query Display 


3. 


If you want to replace the existing prompted query definition with the converted SQL query definition, 
leave the “SQL Query” name unchanged. If you want to keep the existing prompted query definition, 
and save the converted SQL query definition as a new query, type a new name in response to the 
“SQL Query” prompt. 

Query naming conventions are described on page bal 

Press the Enter key to perform the conversion and return to the Work with Query Manager Queries 
display. 

If you did not type a new name in response to the “SQL Query” prompt, Query Manager displays a 
message warning that if you complete the conversion, the existing query definition will be lost. Press 
the Enter key a second time to confirm the conversion and return to the Work with Query Manager 
Queries display. 
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Note that when you press the Enter key, you convert all of the queries shown on the display. If you 
want to leave the Convert Prompted Query to SQL Query display without converting any queries, press 


F3 (Exit) or F12 (Cancel) instead of the Enter key. 
those query objects that you have the authority to replace. See 


Zi for more information. 
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Chapter 6. Working with Query Manager report forms 


This chapter describes Query Manager report forms, telling you what they are, and explaining how to 
create, maintain, and use them. 


Report forms are used to format query data when you run a query or report. Query Manager provides a 
large selection of report formatting options, and its prompt-driven displays make it easy to create both 
simple and complex report forms. 


This chapter begins with some background information on report forms, followed by instructions on how to 
use the options that are available through the Work with Query Manager Report Forms display. You can 
learn how to create, change, copy, delete, rename, display, and print report form definitions, and how to 
run Query Manager reports. 


If you have BASIC access to Query Manager, you can display and print report form definitions, and run 
reports. 


What is a Query Manager report form? 


Report forms are used to format the data that results from running an SQL SELECT statement query or a 
prompted query. 


If you run a query without specifying the report form you want to use to format the query data, Query 
Manager generates a simple default report form. This default report form, called *SYSDFT, arranges the 
columns in the order specified by the query, and inserts the column names (from the tables being queried) 
at the top of each column. 


By creating a report form, you can make the data retrieved by the query easier to read and interpret. You 
can also include summary information and perform arithmetic operations to make the query data more 
meaningful. Although the data generated is determined by the query, you can use the report form to 
specify information and formatting such as: 


¢ The order of the columns 

* The horizontal and vertical position of information 

¢ Meaningful column headings, page headings, and page footings 
¢ Report breaks and summary operations 

¢ Separators to highlight headings and summary data 

¢ Text for the end of the report, including final summary data 


Examples showing how you can use report forms to improve the way that query data is presented, can be 
found in 


You might decide to create several different report forms to use with the same query, so that you can alter 
the appearance of the query data according to your needs. You can also create one report form to use 
with several different queries. 


All of the formatting options that you can use to create and change your report forms are described in 
detail in this chapter. 


Using the work with Query Manager report forms display 


When you want to create, change, or use a report form in any way, the Work with Query Manager Report 
Forms display is the place to begin. 
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You select the Work with Query Manager Report Forms display from the Query Manager main menu. Type 
2 in the Selection prompt; then press the Enter key to go to the Work with Query Manager Report Forms 
display. An example of this display for a user with an ALL access level is shown in Figuesd 


If you have a BASIC access level, the only options shown are 5=Display, 6=Print, and 9=Run report. 


( > 


Work with Query Manager Report Forms 
IDA eerie cence ee convene econ MYLIB Name, F4 for list 
Type options, press Enter. 


l=Create 2=Change 3=Copy 4=Delete 5=Display 6=Print 7=Rename 
9=Run report 


Opt Form Description 
~ FINAL 
_  MYFORM Example form for DB2 UDB for iSeries Query Manager 
— STAFF SELECT * FROM TABLE 
Bottom 
F3=Exit F4=Prompt F5=Refresh Fll=Display form only F12=Cancel 


ELIE Rape se position to F17=Position to F22=QM statement 


Figure 59. Work with Query Manager Report Forms Display 


The report forms listed on this display are those stored in the library shown at the top of the display. 


If you have an ALL access level, the library name is underlined, indicating that it is a prompt value. You 
can type a new library name over the existing name if you want to access report forms from a different 
library. Position the cursor on the Library prompt, and press F4 (Prompt) to display a list of libraries from 
which you can make a selection. You can choose any of the following options to work with a report form: 


1=Create Shows the Select Report Format display, through which you can create a report form 
definition. Choose the parts of the report form that you want to define. Prompt-guided 
displays for each of the parts you choose are shown in the same order as the parts are 
listed on the Select Report Format display. You define the report form through these 
displays, specifying column formats, page headings and footings, text for the end of the 
report, report breaks, and other formatting options. This report form becomes the active 
form. See page } 


2=Change Shows the Select Report Format display, through which you can change the definition of 
the selected report form. Choose the parts of the report form that you want to change; 
then make any changes you require. This report form becomes the active form. See page 


3=Copy Copies a report form. You can replace an existing report form or create a new one. See 
page iss) 

4=Delete Deletes report forms you no longer require. You need to respond to a confirm display 
before the delete occurs. See page i aa] 


5=Display Shows the definition of the report form in display-only format. You cannot change any 
values through this option. The Display Report Format display is shown, prompting you to 
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choose the parts of the report form that you want to display. Displays for each of the parts 
you choose are shown in the same order as the parts are listed on the Display Report 
Format display. See page 1132. 


6=Print Sends a copy of the report form definition to the default printer specified in your Query 
Manager profile. See page ; 


7=Rename Prompts you to specify new names for existing report forms. See page Lad. 


9=Run report Runs a report by applying the specified report form to query data. Before the report is run, 
you can specify run options such as, the query you want to run to generate query data, 
and the mode in which you want to run the query (batch or interactive). The report form 
becomes the active form. If you specify to run a query, that query becomes the active 
query, and the data it generates becomes the active data. See page y 


If you need help selecting report forms from the “Work with” display, see page Hal if you need help using 
the “Work with” display function keys, see page ba. 


Creating or changing a Query Manager report form 


Before you create or change a report form, it is a good idea to run the query that relates to the report 
form, and create active data. Query Manager uses the active data to display the report form, so that you 
can see how the report form is affecting the layout of the query data. You do not need to run a query 
every time you want to display the report form. See 
information. 


Query Manager also extracts information from the active data to insert as default values in the Edit 
Column Formatting display (see Figure 61 on page 119), making it faster for you to complete the 
information for that display. Active data is described on page ii) and running queries is described on page 


You can choose to create or change a report form in the following ways: 


¢ Select option 1 (Create) or 2 (Change) from the Work with Query Manager Report Forms display. This 
method is described over the next few pages. 


The following information applies regardless of the method you use to specify that you want to create or 
change a report form. All methods show the Select Report Format display, through which you select the 
parts of the report form that you want to create or change. 


1. Type 2 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Report Forms display. 


2. To create a report form, type 1 in the Opt prompt next to the blank report form name (at the top of the 
list). You can specify a name for the report form now, or you can leave it unnamed, and specify a 
name when you save the report form through the Exit display. Report form naming conventions are 
described on page bd and saving report forms is described on page fod. Press the Enter key to show 
the Select Report Format display. 


To change a report form, type 2 in the Opt prompt next to the names of the report forms you want to 
change; then press the Enter key. The Select Report Format display is shown for the first report form 
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you specified. Select Report Format displays for the remaining report forms are shown in the same 
order as the report form names appear in the “Work with” display list. 


An example of the Select Report Format display is shown in [Figure 6d. 


Select Report Format 
BORM ces 3) os ce IMNEORM 


Type options, press Enter. Press F21 to select all. 
1=Select 


Opt Report Format 

Edit column formatting 
Edit page heading 

Edit page footing 

Edit final text 

Edit break text 

Specify formatting options 


[epee eae Stie ail 


Bottom 
F3=Exit F5=Run report  F12=Cancel F13=Edit query F18=Display SQL 
oleae all F22=QM statement 


Figure 60. Select Report Format Display 


3. Type 1 in the Opt prompt next to the parts of the report form you want to create or change; then press 
the Enter key. You can choose all parts by pressing F21 (Select all). 


4. Create or change the report form by completing the parts that you selected through the Select Report 
Format display. 


Edit column formatting see page FETe| 
Edit page heading see page ho 
Edit page footing see page hs) 
Edit final text see page f28] 
Edit break text see page isd) 


Specify formatting options see page f3al 


Headings, footings, break text, and final text can include both uppercase and lowercase characters. 

5. When you finish entering the information for one display, press the Enter key to go to the next display. 
All displays are shown in the same order as the parts are listed on the Select Report Format display. 
When you finish entering information for all of the parts that you selected in step 8, press the Enter key 
to return to the Select Report Format display. From this display, you can once again select parts of the 
report form to create or change (as described in step bh if you need to. 

6. To display the report form and see how it is affecting the layout of the active data, press the F5 
function key. The title of the F5 key changes depending on the active data: 
¢ If the active data is the result of running a full query, the key is labeled (Display report). 
¢ If the active data is the result of running a sample query, the key is labeled (Display sample). 

* If there is no active data, or if the active data does not match the report form, the key is labeled 
(Run report). 


Displaying or running the report is described in 
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7. When you finish working with the report form, press F3 (Exit) to leave the Select Report Format display 
and go to the Exit display. Query Manager validates the report form, and makes sure it contains no 
errors before the Exit display is shown. Through the Exit display, you specify whether you want to save 
the report form, and whether you want to change its name. 


If you are creating a report form, enter a name and description for the report form through the Exit 
display. If the report form is already bee can change the name if you desire. Report form 
naming conventions are described on page 29, and descriptions can be a maximum of 50 characters 
in length. 


If you are changing a report form, you can save the changed report form under its existing name and 
replace the old report form, or you can save it under a new name and keep both copies of the report 
form. You can also change the description of the report form. The Exit display is the only place where 
you can change report form descriptions. 


Type 1 to save the report form, or 2 to discard it; then press the Enter key to return to the Work with 
Query Manager Report Forms display, or the Work with Query Manager Queries display. The Exit 
display is described on page ‘ 

If you have not changed the report form definition, you can press F12 (Cancel) instead of F3 (Exit) to 
leave the Select Report Format display. F12 takes you directly to the Work with Query Manager Report 
Forms display; the Exit display is not shown. 


Note: If you chose to create or change a report form by selecting “Specify report formatting” from the 
Define Prompted Query display, or by pressing F13 (Edit form) from the Edit Query display, you 
can press F13 (Edit query) when you finish working with the Report Form to return to the query 
editor. When you press F3 (Exit) to leave the query editor, the Exit display asks whether you 
want to save both the query and the report form. 


If you want to work through practice exercises in which you create and work with a Query Manager report 
form, turn tolA e 


Testing a report form 


At any time while you are creating or changing a report form, you can check to see how the current 
definition of the report form is affecting the appearance of the report. 


To view the layout of the report, press the F5 function key. The title of the F5 key changes depending on 
the active data: 

* lf the active data is the result of running a full query, the key is labeled (Display report). 

¢ If the active data is the result of running a sample query, the key is labeled (Display sample). 


¢ If there is no active data, or if the active data does not match the report form, the key is labeled (Run 
report). 


Note: For the active data to match the report form, they both need to contain the same number of 
columns, and the columns need to have compatible data types. Active data is described on page ia. 


When you first press F5, Query Manager validates your report form. If any errors are found in the report 
form definition, an error message is shown at the bottom of the display, and the report is not displayed or 
run. 


If the report form is valid, and F5 is labeled (Display report) or (Display sample), the report form is applied 
to the active data, and the resulting report is shown on your display. 


If the report form is valid, and F5 is labeled (Run report), the Run Query display is shown, prompting you 
to specify run options. Enter information such as the name of the query you want to run, and the mode in 


which you want to run the query. The Run Query display options are described in Fusing the run querd 
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Editing or displaying the active query 
While you are creating or changing a report form, you can press F13 (Edit query) to create or change the 
query that you want to use with the report form. 


When you press F13 (Edit query), Query Manager shows the active query in the query editor display. If 
there is no active query, a prompt display asks you to type the name of the query that you want to create 
or change, and the library in which it resides. You can press F4 (Prompt) to display a list of all queries in 
the current library from which you can make a selection. 


Type a new name to create a new query, or type the name of an existing query that you want to change; 
then press the Enter key. New queries are created in your default query creation mode: either prompted or 
SQL. Existing queries are changed in the mode in which they were last saved. See See RIOTS 
for instructions. 


Note: If “Allow change query creation mode” is set to NO in your Query Manager profile, you can change 
only those queries that were last saved in your default query creation mode. The only SQL queries 
you can change are those that contain one of the SQL statements you have been granted authority 
to use (through your Query Manager profile). 


When you finish editing the query, and you want to return to the Select Report Formatting display: 
¢ If you are editing an SQL query, press F13 (Edit form). 


* If you are editing a prompted query, choose to “Specify report formatting” from the Define Prompted 
Query display. 


If you want to view (rather than edit) the SQL SELECT statement that defines the active query, press F18 
(Display SQL). If there is no active query, Query Manager displays an error message. When you choose to 
display SQL for a prompted query, the SELECT statement is shown with descriptive comments, in the 
same format as prompted query definitions are printed. See Eigura 27 on papa ad for an example of the 
format in which the SQL statement is presented. 


The F13 (Edit query) and F18 (Display SQL) keys are available from most of the report formatting 
displays. 


Loading default values from the active query in Query Manager 


When you create or change a report form as part of a prompted query definition, Query Manager takes 
values from the query definition and inserts them as default values in the Edit Column Formatting display. 


nese default values make it faster and easier for you to complete the information for the display. (Turn to 
J if you want to see an example of the Edit Column Formatting display.) 


If the report form you are creating or changing is not part of a promptedquery definition, Query Manager 
takes values from the active data, and inserts them as default values in the Edit Column Formatting 
display. The default values inserted from the active data are the column names, headings, sequence, and 
widths. (Active data is created when you interactively run an SQL SELECTstatement query or a prompted 


query.) 


You can also choose to load default values from the active query, by pressing F19 (Load from query). This 
loads the following default values from the query definition: 


* The columns selected by the query are inserted as default column names and headings. 
* The column usage values are blank. 

* The column edit codes are blank. 

¢ Columns are sequenced in the same order as they are selected by the query. 

¢ The indent defaults to 2 spaces. 
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* The width values are inserted from the column selected by the query. 


Note that if your Query Manager profile is set so that you can run queries only in batch mode and “Allow 
interactive sample run” is NO, you cannot create active data. The only way that you can load default 
values when you create a report form is by pressing F19 (Load from query). 


The F19 function key is available from the Edit Column Formatting display. See 
fisitapae fads Quad Mancoallicimore inionmetion 


Formatting the columns in the report form in Query Manager 


If you choose to edit column formatting from the Select Report Format display (see page Quer 
Manager shows the Edit Column Formatting display. An example of this display is shown in You 
can specify the following information through this display: 


* The heading text for each column 

* Any special usage to apply to a column: for example, report breaks, and summary operations 
* The data type and format of the data in each column 

¢ The order in which the columns are to appear (left to right) 

* The spacing between columns 

* The width of each column 


Edit Column Formatting ) 
Type information, press Enter. 
For Usage and Edit, press F4 for list. 
For Heading, press F4 for prompt. 
Column Heading Usage Edit Seq Indent Width 
DEPT DEPT af 2 14 
NAME NAME 2 2 9 
JOB JOB 3 2 5 
SALARY SALARY 4 Z 13 
COMM COMM 5 2 10 
Bottom 
F2=Alternate keys F3=Exit F4=Prompt  F5=Run report F6=Insert line 
F10=Copy line F11l=Edit heading F12=Cancel F24=More keys 7 
; % 
F2=Base keys F3=Exit F4=Prompt F5=Refresh F6=Insert line 
Fl0=Copy line F1l=Edit heading F12=Cancel F24=More keys S) 
> 
F13=Edit query Fl4=Delete line F18=Display SQL F19=Load from query 
F20=Display entire name F22=QM statement F24=More keys +) 


Figure 61. Edit Column Formatting Display 


If you are creating a report form as part of a prompted query definition, Query Manager inserts default 
values in the Column and Heading prompts based on the query definition. 
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If the report form you are creating is not part of a prompted query definition and there is active data, Query 
Manager inserts default values in the Column, Heading, and Width prompts based on the active data, as 
shown in the [Figure 61 on page 119. If there is no active data, the Columns are numbered sequentially, 
and the Headings and Widths are blank. You can also load default values from the active query, b 


ressing F19 (Load from query). See 
hage 11d for instructions. 


When you create and change the report form, you can insert, copy, and delete lines using the F6 (Insert 
line), F10 (Copy line), and F14 (Delete line) function keys. These function keys are described on page bd. 


Enter the following information through the Edit Column Formatting displays: 

¢ Column headings 
There are two ways in which you can enter and edit column headings. The headings are not entered 
through the main Edit Column Formatting display (shown in Sere eerETE Instead, you need 
to use one of two separate displays: one of which prompts you to enter headings for all columns, while 
the other prompts you to enter all details (including column heading) for a specific column. 


— Press F11 (Edit heading) to show the display through which you can enter headings for all columns. 
shows the display you go to when you press F11 (Edit heading). 


fe ; ; = 
Edit Column Formatting 
Type information, press Enter. 
For Usage and Edit, press F4 for list. 
For Heading, press F4 for prompt. 
Column Heading 
DEPT Dept_ID 
NAME Employee_Name 
JOB Job_Title 
SALARY Salary_earned 
COMM Commission_paid_against_advance 
Bottom 
F2=Alternate keys F3=Exit  F4=Prompt F5=Run report F6=Insert line 
F10=Copy line F1ll=Edit usage F12=Cancel F24=More keys 
& 7 
. = 
F13=Edit query F14=Delete line F18=Display SQL F19=Load from query 


\_ Fee Disp lay entire name F22=QM Statement F24=More keys 


Figure 62. Edit Column Heading Display 


Type a heading for each of the report columns. When you finish specifying column headings and 
want to return to the main Edit Column Formatting display, press F11 (Edit Usage). 


— Position the cursor on the Heading, Sequence, Indent, or Width prompt for a particular column; then 
press F4 (Prompt) to show the display through which you can enter all values for that column, 
including the column heading. Fig es on gecesi shows the display you go to when you press 
F4 (Prompt). 
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Edit Column Formatting 


Column’ ea Soe ee es Se ee DEPT. 

Type information, press Enter. 
H@adanGe 2s Se ee eh eee eos ey eos Dept_ID 
WAG Cr eesres eu conves tan cou omen castsats F4 for list 
Editing 2. 58,0 sos eos ee St me F4 for list 
Sequence in report. ...... 1 1-999 
Tndents teats ea cnre veut tes ersa sare 2 0-999 
Displayed width .. ¢ «208. % 6 1-32767 


Bottom 
F2=Alternate keys F3=Exit F4=Prompt F5=Run report  F12=Cancel 
F13=Edit query F18=Display SQL F22=QM statement 


Figure 63. Edit Column Information Display 


You can enter all of the values for the selected column through the display shown in [Figure 6d, 
including the column heading. When you finish specifying the column information and want to return 
to the main Edit Column Formatting display, press the Enter key. 


Headings can contain uppercase and lowercase letters, numbers, spaces, and special characters. To 
specify a blank heading for a column, type *NONE. If you do not enter heading text or *NONE for a 
column, Query Manager uses the column name defined in the database for each column retrieved by 
the query. 


Headings can also contain double-byte character set (DBCS) characters. Note that when you enter 
DBCS strings through any of the Select Report Format displays, you need to enclose the strings in 
shift-out and shift-in characters. See = 64) for 
more information on DBCS values. 


If you want the column heading to appear on two or more lines, include an underscore (_) in the 
heading at the position at which you want the heading to break to the next line. A column heading can 
be a maximum of nine lines. For example, entering a heading of: 


Salary_to date 


causes the following two line column heading to appear in the report: 


Salary 
to date 


When you return to the main Edit Column Formatting display, any headings you entered are inserted in 
the Heading column. If any heading is more than 25 characters in length, Query Manager truncates it, 
and adds “...” to the end of the displayed portion of the heading to indicate that it has been truncated. 
Press F4 (Prompt) or F11 (Edit Heading) to view the entire heading. 

* Column usage 
Column usage determines how a column is used in the report form. For example, you can specify that 


you want a column to be totalled, averaged, used as a report break, or omitted from the report. Choose 
one of the usage codes from Tepe aon meas ied 
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Table 8. Options Available for Column Usage 


Usage Code Definition 

[blank] Include the column in the report. 

OMIT Exclude the column from the report. 

AVERAGE (AVG) Average all values in the column. 

COUNT Count the number of non-null values in the column, 
including repeated values. 

FIRST The first value in the column. 

LAST The last value in the column. 

MAXIMUM (MAX) The maximum value in the column. 

MINIMUM (MIN) The minimum value in the column. 

SUM Total all values in the column. 

BREAKn Cause a new grouping of details lines to occur in the 


report when the value in the column changes. n can be a 
value from 1 to 6 to specify up to six levels of report 
breaks, where_1 is the highest break level and 6 is the 


Note that the COUNT column usage for report formatting is not the same as the COUNT summary 
function for prompted query. Null values are included in the total when the COUNT summary function is 
specified through prompted query. Null values are not included in the total when the COUNT column 
usage is specified through report formatting. 


The AVERAGE, COUNT, FIRST, LAST, MAXIMUM, MINIMUM, and SUM column usages can insert 
summary information at the end of the report. If you specify report breaks, you can also insert summary 
information for each break. 


When you specify a BREAK column usage, you should make sure that the query sorts the data by the 
columns for which you have specified breaks. You sort query data using the ORDER BY clause of the 
SELECT statement. Using report breaks is described on page a. 


You might want to specify the OMIT column usage when you are using a query that selects many 
columns. Specify OMIT when you want to use a number of different report forms with the same query 
data. By omitting columns from reports, you can run the query once; then produce reports using two (or 
more) different report forms. You can also specify OMIT when you want to use column data as 
substitution values in Break Text or Final Text, but you do not want the column data in the body of the 
report. 


Position the cursor on the Usage prompt and press F4 (Prompt) to display a full list of the supported 
usage values, from which you can make a selection. You can specify only one usage value for each 
column. 


When you create a report form, the column Usage prompts default to blanks. 
* Edit code 


Edit codes specify the format in which column values appear in the report. There are a number of 
different formats in which character, number, date, and time information can appear, as described in 
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Table 9. Edit Codes for Column Data 


Edit codes for character data: 


Code Description 

Cc If the text cannot fit on one line in the column, the text is truncated according to the 
width of the column. 

CW If the text cannot fit on one line in the column, the text is wrapped according to the 
width of the column. 

CT If the text cannot fit on one line in the column, the text is wrapped according to spaces 


(blanks) or full words, if possible. 


Edit codes for graphic data: 


Code Description 

G If the value cannot fit on one line in the column, the value is truncated according to the 
width of the column. 

GW If the value cannot fit on one line in the column, the value is wrapped according to the 


width of the column. 


Edit codes for numeric data: The examples show how the codes might format the number -1234567.89. The 
character following the code (n) indicates the number of decimal places and can be any number from 0 through 31. 


The examples assume two decimal places. 


Code Note 

E Scientific notation 

Dn Currency symbol and 
thousands separators 

In Leading zeros 

Jn Leading zeros, no negative 
sign 

Kn Thousands separators 

Ln Decimal notation 

Pn Percent sign and thousands 


separators 


Edit codes for dates: The date separator (x) can be any special character, including blank, but not a letter or 


number. The examples assume the slash (/). 


Example 
-1.23456789E+06 
-$1,234, 567.89 


-0001234567.89 
00001234567 .89 


-1,234,567.89 
-1234567.89 
-1,234,567.89% 


Code Format 
TDYx YYYYxMMxDD 
TDMx MMxDDxYYYY 
TDDx DDXMMxYYYY 
TDYAx YYXMMxDD 
TDMAx MMxDDxYY 
TDDAx DDXMMxYY 


Edit codes for times: The time separator (x) can be any special character, including blank, but not a letter or 


number. The examples assume the colon (:). 


Example 
1992/08/29 
08/29/1992 
29/08/1992 
92/08/29 
08/29/92 
29/08/92 


Code Format Note Example 
TTSx HHXMMxSS Includes seconds 13:42:35 
TTCx HHxMMxSS Includes seconds, 12 hour 01:42:35 
clock 
TTAx HHxMM Abbreviated (no seconds) 13:42 
TTAN HHMM Abbreviated, no separator 1342 
TTUx HHxMM AM/PM USA style 01:42 PM 
Edit code for timestamp: 
Code Format Example 
TSI YYYY-MM-DD- 1992-01-31-13.42.19.123456 


HH.MM.SS.NNNNNN 
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When you create a report form, the Edit code prompts default to blanks. If you leave these values 
blank, Query Manager inserts default values when the report is run. The default edit codes are the data 
types defined in the database for each column retrieved by the query. 


To specify an edit code, type one of the values listed in [Table 9 on page 123) For some edit codes, you 
also need to specify a qualifier. Enter the qualifier as the final character of the code. 


— For numeric codes other than E, you can specify the number of decimal places. Type a number from 
0 to 31. If you do not enter a number, zero is assumed. If a column value has more decimal places 
than you specify, the value is rounded. If a column value has fewer decimal places than you specify, 
the value is padded with zeros. 


— For date and time codes other than TTAN, you can specify the character you want to use to 
separate the parts of the dates and times. The separator can be any special character, including a 
blank, but it cannot be a letter or number. 


Position the cursor on the Edit prompt and press F4 (Prompt) to display a list of the supported Edit 
codes from which you can make a selection. A prompt window asks you whether the data is Character, 
Numeric, Date and Time, or Graphic. Specify the data type and press the Enter key. Query Manager 
then shows a Select Column Editing prompt window, listing the available selections for the data type 
you specified. 


Only those codes that are applicable to the specified data type are shown. An example of the prompt 
window for numeric data is shown in Figuia ed 


@ >) 
Edit Column Formatting 
Type information, press Enter. 
ROM core suere, ots iesevane exstesstaie siorsvstolareie/sietsisisie ors sueceseseietelsrcnezecene 
H Select Column Editing b 
Col : : t Seq Indent Width 
DEP : Decimal places... 2. __ 9-31 aes 1 Z 6 
NAM : - 2 2 9 
JOB : Type option, press Enter. _ 3 2 i} 
SAL : 1=Select = 4 2 10 
COM : a 5 2 8 
E Opt Edit Example 
= D -$12,345.67 
if I -0012345.67 
eo J 00012345 .67 
K -12,345.67 
More... 
F12=Cancel 
Bottom 
F2=Alternate keys F3=Exit F4=Prompt F5=Run report F6=Insert line 
ee line F11l=Edit heading F12=Cancel F24=More keys ay 


Figure 64. The Select Edit Code Prompt 


Seq 


Seq (Sequence) specifies the order in which you want columns to appear in the report. The default is 
for columns to appear in the same order as they are selected by the query. The following rules apply 
when specifying sequence numbers: 


— Type any number from 1 through 999. 
— Numbers do not need to be consecutive. 


Columns with the same sequence number appear as adjacent columns in the report, in the same 
order as they are selected by the query. 
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Column sequence is particularly important when your report contains breaks and summary data. To 
make the report easier to read, we recommend that you specify a column sequence so that break 
columns appear on the left of the report (low sequence numbers), and summary data columns appear 
on the right (high sequence numbers). 


¢ Indent 


Indent specifies the spacing between columns. For each column, specify the number of blank character 
spaces that you want to appear to the left of the column value. For the first column in the report, you 
specify the number of spaces you want to indent the column from the edge of the page or display. For 
all remaining columns, you specify the number of spaces you want to indent the left edge of each 
column from the right edge of the previous column. 


You can set the indent to any value from 0 through 999, but a blank value is not permitted. The default 
is two spaces. 


* Width 


Width specifies the maximum number of characters in which to display or print the column values and 
heading. A report can be a maximum of 32767 character spaces wide, or 16383 graphic spaces wide. 


When you create a report form using active data, Query Manager inserts default widths to the report 
form definition. The default widths are the widths of the columns (as defined in the database) or the 
widths of the column names, whichever is greater. 


Query Manager adjusts the default widths when you change some of the column formatting attributes 
such as heading, usage, or edit. If you change a default column width to a specific width, the automatic 
adjustment is lost for that column width. For example, a column heading will be truncated if you specify 
a column width smaller than the heading text. 


If you insert a line (column) the default column widths are lost. The report form no longer matches the 
table on which it is based and the default widths no longer have meaning. 


The width prompt is blank for all columns when you create a report form without active data, when you 
create the report form as part of a prompted query definition, or when you load default values from the 
active query using F19 (Load from query). If you leave the width prompt blank, or if you blank out the 
value shown in the width prompt, Query Manager inserts run-time defaults when the report is run. The 
run-time defaults are the widths of the columns (as defined in the database) or the widths of the column 
headings, whichever is greater. 


If a column heading is wider than the specified width, the heading is truncated. If a column value is 
wider than the specified width, numeric data is replaced by a row of asterisks (*****), and character and 
graphic data is truncated at the right. (If character or graphic data has an edit code of CW, CT, or GW, 
the column value wraps onto the next line.) 


Specifying page headings and footings in Query Manager 
When you choose to edit page headings or footings from the Select Report Format display (see page 

, Query Manager shows the Edit Page Head and Edit Page Footing displays. An example of the 
Edit Page Heading display is shown in }. Through these displays, you specify the 
text that you want to appear at the top and peioni of Sach page of the report, and the position on the 
page where you want the heading and footing text to appear. 
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Edit Page Heading 
Type choices, press Enter. 
Blank: lines before: ss it a ew A ee 0 0-999 
Billankslkines:atters <2 secre es 00 ccc cues ees 2 0-999 


Page text: Use &col, &DATE, &TIME, and &PAGE to cause variable insertion. 


Line Align Page Heading Text 
1 CENTER 
2 CENTER 
3 CENTER 
4 CENTER 
5 CENTER 
Bottom 
F2=Alternate keys F3=Exit F4=Prompt F5=Run report Fo=Insert line 
eee line F12=Cancel F13=Edit query F14=Delete line F24=More keys ) 
- 
F2=Base keys F3=Exit F4=Prompt F5=Refresh F6=Insert line 
RonEAetOpy line  F12=Cancel F13=Edit query F14=Delete line F24=More keys iy 
he > 
F18=Display SQL F22=QM statement F24=More keys 
XX yy 


Figure 65. Edit Page Heading Display 


When you create and change the heading and footing text, you can insert, copy, and delete lines using the 
F6 (Insert line), F10 (Copy line), and F14 (Delete line) function keys. These function keys are described on 
page (29. Note that when you copy lines, the entire line is copied: text, line number, and alignment. 


Page headings and footings can contain a maximum of 999 lines each. When creating a report form, the 
default number of lines is five. 


Note: Page headings appear only in printed reports. When you send your report output to display, the first 
line shown in the report is the column headings. 


The information you can enter when defining page headings and footings is described in the next few 

pages. 

* Blank lines before and after 
For headings: type a number for “Blank lines before” to specify the number of blank lines you want to 
appear between the top of the page and the first line of heading text. Then, type a number for “Blank 
lines after” to specify the number of blank lines you want to appear between the last line of heading text 
and the body of the report. 
For footings: type a number for “Blank lines before” to specify the number of blank lines you want to 
appear between the report body and the first line of footing text. Then, type a number for “Blank lines 
after’ to specify the number of blank lines you want to appear between the last line of footing text and 
the bottom of the page. 
You can type any number in the range 0 to 999. When you create a report form, the default values for 
headings is 0 lines before and 2 after, and for footings is 2 lines before and 0 after. 
The blank lines before and after apply even when you do not specify any text for the page heading or 
footing. 
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Line numbers 


The sequence of text lines within the heading and footing is determined by the number in the Line 
prompt. The line with the lowest number appears first, and the line with the highest number appears 
last. To insert a blank line, simply omit the line number from the display; then specify text for one or 
more of the following lines. Line numbers do not have to be consecutive, nor do they have to be 
entered in this display in ascending order. 

You can assign the same line number for up to three text entry lines in this display, as long as the 
alignments are different for each entry line. For example, in the Edit Page Heading display the following 
choices: 


Line Align Page Heading Text 
1 LEFT &DATE 
1 CENTER Weekly Sales Report 
1 RIGHT Page &PAGE 
3 LEFT Dept &1; 


would generate a page heading with 3 lines, the second of which would be blank: 
10/12/1992 Weekly Sales Report Page 1 


Dept 10 


Note: When you press F5 to run a report and direct the output to display, if there are duplicate line 
numbers, Query Manager displays a message warning you that some text might be overlaid by 
text from another line. To continue running the report, press F5 again. 


Text alignment 


The Align prompt controls the position of the page heading or footing text on the report line. Type one of 
the following alignments: 


— RIGHT or R to right justify the text. 
— LEFT or L to left justify the text. 
— CENTER or C to center the text. 


You can press F4 (Prompt) when the cursor is positioned in the Align prompt to display a list of these 
values. 


= 
Edit Page Footing 
Type choices, press Enter. 
Blank lines before: .. 6 ca tel ote, ers Ses Os a 0-999 
Bilankdines:-aiter. sit sy unet eect rete Je On. 0-999 
Page text: Use &col, &DATE, &TIME, and &PAGE to cause variable insertion. 
Line Align Page Footing Text 
1 CENTER 
2 CENTER 
3 CENTER 
y 


Figure 66. Edit Page Footing Display 


¢ Page heading or footing text 


Use the “Page Heading Text” and “Page Footing Text” prompts to type the text that you want to appear 
as the page heading or footing. You can type up to 55 characters on each line. The lines can then be 
aligned either left, right, or center. 

If you want to include blank spaces in the heading or footing text, leading blanks are always included, 
but trailing blanks are included only when you enclose the entire text in ‘single’ quotation marks. 
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Blank lines are inserted in the heading or footing when you omit a line number from the description, and 
specify text for one or more of the following lines. An example of this is shown on page 271 


You can include the following variables in your heading or footing text: 


&col Specifies a column name or number. In a page heading, &col has the first value on the 
page for the specified column. In a page footing, &col has the last value on the page for 
the specified column. The column value is in the format you specified for the Edit 
prompt on the Edit Formatting display, unless you specify column wrapping. Column 
wrapping is ignored when the column value is formatted into the text. 


The column name is the name of column returned from DB2 UDB for iSeries SQL. You 
must enter the column name in capital (uppercase) letters. You must refer to the column 
by column number if the column name is DATE, TIME, PAGE, or the column name 
contains a $, #, @, or a quote. To obtain the column name of a duplicate column, 
expression, or summary function, use the Edit Column Formatting display. 


The column number is determined by the sequence in which the columns are retrieved 
by the SELECT statement query or the prompted query. The order of the column 
numbers are not the same as the order you specify in the Seq column in the Edit 
Formatting display. 


You might find this variable useful in reports that contain breaks. For example, you can 
specify a new page each time the value in the break column changes. By using the 
&col variable, you can include the break value in the page heading or footing. 


&DATE Inserts the current or report date. You need to type the word DATE in uppercase. 

&TIME Inserts the current or report time. You need to type the word TIME in uppercase. 

&PAGE Inserts the current page number in the report. You need to type the word PAGE in 
uppercase. 


Specifying text for the end of the report in Query Manager 


If you choose to edit final text from the Select Report Format display (See page , Query Manager 
shows the Edit Final Text display. An example of this display is shown in . Use this 
display to specify the text that you want to appear at the end of the report, the position in which you want 


the final text to appear, and the line within the final text on which you want to include final summary 
information. 
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Edit Final Text 


Type choices, press Enter. 


New page for final text ......... N Y=Yes, N=No 
Blank limes: before . «6 « 4 «5 « « «4 « 0 0-999, BOTTOM 
Put final summary at line ........ Sy 0-999, NONE 


Final text: Use &col to cause variable insertion. 


Line Align Final Text 
1 RIGHT 
RIGHT. 
RIGHT 
RIGHT. 
RIGHT. 
RIGHT. 
RIGHT. 
RIGHT 
RIGHT. 
RIGHT. 


SWNaAnDG AWD 


— 


More... 
F2=Alternate keys F3=Exit F4=Prompt F5=Run report F6=Insert line 
F10=Copy line F12=Cancel F13=Edit query F14=Delete line F24=More keys 


F2=Base keys F3=Exit F4=Prompt F5=Refresh Fo=Insert line 
Fl0=Copy line  F12=Cancel F13=Edit query F14=Delete line F24=More keys 


We Nay 


(aes SQL F22=QM statement F24=More keys 


Figure 67. Edit Final Text Display 


When you create and change the final text, you can insert, copy, and delete lines using the F6 (Insert 
line), F10 (Copy line), and F14 (Delete line) function keys. These function keys are described on page 2d. 
Note that when you copy lines, the entire line is copied: text, line number, and alignment. 


Final text can contain a maximum of 999 lines. When creating a report form, the default number of lines is 
twelve. 


Enter the following information to define the final text for the report. 

* New page for final text 
Type Y if you want the final text to begin on a new page. If you type N and there is not enough space 
on the current page for the final text in its entirety, the final text begins on a new page. 

* Blank lines before 


Specify the number of blank lines you want to appear between the last line of the report body and the 
first line of the final text. If you choose to include final summary separators (through the Specify Report 
Formatting Options display, see page 1134), the separator line is considered the last line of the report 
body. 

You can type any number between 0 and 999. When you create a report form, the default value is 0 
lines. For printed reports, you can also specify BOTTOM, to position the final text immediately before 
any page footing text specified for the page. If there is not enough space for the final text on the current 
page, it is placed at the bottom of the next page. 


¢ Put final summary at line 
Specify whether you want final summary data to appear in the report, and if so, the line on which you 


want it to appear within the final text. If the report does not generate summary data, this value is 
ignored. An example of final summary data is shown in SCRE | 
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Specify a line number between 1 and 999, or type NONE to suppress the final summary. The line 
number you type here specifies the line within the final text on which you want the summary data to 
appear. The summary data is shown beneath the column being summarized. If the number you type is 
greater than the number of formatted final text lines, blank lines are inserted to make up the required 
number. When you create a report form, the default line number is 1. 


If you type a line number of NONE, it suppresses final summary information, but has no effect of break 
summary information, including any breaks that may occur at the end of the report. 


Final summary information is the values that are calculated for the entire report, for example, a grand 
total. This differs to break summary information which is calculated from one report break to the next. 
You specify summary functions and report breaks through the Usage prompt in the Edit Column 
Formatting display. See page for more information. 


¢ Line numbers 

Specify line numbers in the same way as you do for page heading and footing text. See page Lod. 
* Text alignment 

Specify text alignment in the same way as you do for page heading and footing text. See page lo. 
° Final text 

Specify final text in the same way as you do for page heading and footing text. See page Loz. 


You can only use the &col insert variable. You cannot include &DATE, &TIME, or &PAGE variables in 
final text. The value of the &col variable is the last value of the last record in the specified column. The 
column value is in the format you specified for the Edit prompt on the Edit Formatting display, unless 
you specify column wrapping. Column wrapping is ignored when the column value is formatted into the 
text. 

The column name is the name of the column returned from DB2 UDB for iSeries SQL. Specify the 
name in uppercase. To obtain the column name of a duplicate column, expression, or summary 
function, use the Edit Column Formatting display. 

The column number is determined by the sequence in which the columns are retrieved by the SELECT 
statement query or the prompted query. The column number is not the same as the order you specify in 
the Seq column on the Edit Formatting display. 


Specifying text for each report break in Query Manager 


If you choose to edit break text from the Select Report Format display (see page 14), Quer Manager 
shows the Edit Break Text display. An example of this display is shown in : 
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Edit Break Text 


Type options, press Enter. 
l=Heading text 2=Footing text 


Break 
Opt Level Columns with this Break Level 
1 1 DEPT 
2 2 JOB 


Bottom 
F2=Alternate keys F3=Exit F5=Run report F12=Cancel F13=Edit query 
F18=Display SQL F22=QM statement 


y 
; . 

F2=Base keys F3=Exit F5=Refresh F12=Cancel F13=Edit query 
F18=Display SQL F22=QM statement 5, 


Figure 68. Edit Break Text Display 


All of the columns for which you specified a break level are listed on the display. (Specifying break levels 
is described on page i221.) If there is active data that matches the current report form, or if default values 
have been loaded from the active query, the column names are shown on this display. If there is no 
matching active data or query default values, the column numbers are shown. 


Use the Edit Break Text display to specify the type of break text (if any) that you want to appear for the 
different break levels. A break heading is text that introduces the following group of report detail lines. A 
break footing is text that follows the report break, and is useful when you want to add descriptive text to 
summary data. 


To specify heading text for a break, type 1 in the Opt prompt next to the break level. To specify footing 
text, type 2 in the Opt prompt next to the break level. Press the Enter key to show the Edit Break Heading 
and Edit Break Footing displays. The displays are shown in the same order as the report breaks are listed 
on the Edit Break Text display. 


The information that you enter through these displays to define the break headings and footings is 
described over the following pages. When you complete entering the heading and footing text, press the 
Enter key to return to the Edit Break Text display. 


You cannot specify both heading and footing text for the same break level in a single operation. Specify to 
enter either heading text or footing text for the required break. When you complete the heading or footing 
text, press the Enter key to return to the Edit Break Text display. You can now specify to enter either 
footing text or heading text for the same break level. 


Figure 69 on page 132) shows the Edit Break Heading display. 
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Edit Break Heading 
Break level’ = 24 45 208 1 


Type choices, press Enter. 


PUL ON TOW Page «6 « ws a ee a we eS N Y=Yes, N=No 
Repeat column heading .......... N Y=Yes, N=No 
Blank inesuibefores..2 1. 2s =) i ese Ore 0-999 
Blank dhinessatiters <4 io sas, 3 os aS 0 0-999 


Break text: Use &col to cause variable insertion. 


Line Align Break Heading Text 
dd  EERT. 
2 LERT 
3: LEED 
4 LEFT. 
See LER 
Bottom 
F2=Alternate keys F3=Exit F4=Prompt F5=Run report F6=Insert line 
eee line F12=Cancel F13=Edit query F14=Delete line F24=More keys ) 
- 
F2=Base keys F3=Exit F4=Prompt F5=Refresh F6=Insert line 
RonTaetOpy line  F12=Cancel F13=Edit query F14=Delete line F24=More keys iy 
fa > 
Coe ey SQL  F22=QM statement F24=More keys ) 


Figure 69. Edit Break Heading Display 


When you create and change the break heading and footing text, you can insert, copy, and delete lines 
using the F6 (Insert line), F10 (Copy line), and F14 (Delete line) function keys. These function keys are 
described on page (24. Note that when you copy lines, the entire line is copied: text, line number, and 
alignment. 


Break headings and footings can contain a maximum of 999 lines each. When creating a report form, the 
default number of lines is five. 


Enter the following information to define your break headings and footings. 

* Put on new page 
Specified for both break heading and break footing text. Type Y if you want the break text to begin on a 
separate page. 

* Repeat column heading 


For break headings: specify whether you want column headings repeated above the detail lines for the 
break group. 
Column headings always appear at the top of each page or display. If you type Y for this prompt, the 
column headings also appear at the start of each break group. This happens regardless of whether you 
specify any break heading text. However, if the break starts at the top of a printed page, only one set of 
column headings appears. 

* Blank lines before and after 
For break headings: type a number for “Blank lines before” to specify the number of blank lines you 
want to appear between the previous detail line and the first break heading line. Then, type a number 
for “Blank lines after’ to specify the number of blank lines you want to appear between the last break 
heading line and the next detail line. 
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For break footings: type a number for “Blank lines before” to specify the number of blank lines you want 
to appear between the last detail line and the first break footing line. Then, type a number for “Blank 
lines after” to specify the number of blank lines you want to appear between the last break footing line 
and the next detail line. 


You can type any number in the range 0 to 999. For printed reports, you can also type BOTTOM to 
specify the blank lines before a break footing. This causes the break footing text to appear immediately 
before any page footing text specified. It also forces a page break, and all following text appears on the 
next page. 

When you create a report form, the default values for break headings is 0 lines before and 0 after, and 
for break footings is O lines before and 1 after. 


The blank lines before and after apply even when you do not specify any text for the heading or footing. 
Put break summary at line 


For break footings: specify whether you want break summary data to appear in the report for this break 
level, and if so, the line on which you want it to appear within the break footing text. If the report does 
not generate summary data, this value is ignored. 

You can type any number between 1 and 999, or type NONE to suppress the break summary data. The 
line number you type here specifies the line number within the break footing on which you want the 
summary data to appear. The summary data is shown beneath the column being summarized. If the 
number you type is greater than the number of formatted break footing lines, blank lines are inserted to 
make up the required number. When you create a report form, the default line number is 1. 


If you type a line number of NONE, it suppresses break summary data, but has no effect on final 
summary data. Type NONE when you want final summary data to appear in the report, but you do not 
want summary data at each break. 


The break summary values are those calculated from one report break to the next. This differs from 
final summary values, which are calculated for the entire report: for example, a grand total. You specify 
summary functions and report breaks through the Usage prompt in the Edit Column Formatting display. 
See page 1119] for more information. 

Line numbers 

Specify line numbers in the same way as you do for page heading and footing text. See page L124. 
Text alignment 

Specify text alignment in the same way as you do for page heading and footing text. See page L271. 
Break heading or footing text 

Specify break heading and footing text in the same way as you do for page heading and footing text. 
See page 27 

You can only use the &col insert variable. You cannot include &DATE, &TIME, or &PAGE variables in 
break heading or footing text. The value of the &col variable is the last value of the last record in the 
specified column. The column value is in the format you specified for the Edit prompt on the Edit 


Formatting display, unless you specify column wrapping. Column wrapping is ignored when the column 
value is formatted into the text. 

The column name is the name of the column returned from DB2 UDB for iSeries SQL. Specify the 
name in capital (uppercase) letters. You must refer to the column by column number if the column name 
is DATE, TIME, PAGE, or the column name contains a $, #, @, or a quote. To obtain the column name 
of a duplicate column, expression, or summary function use the Edit Column Formatting display. 


The column number is determined by the sequence in which the columns are retrieved by the SELECT 
statement query or the prompted query. The column number is not the order you specify in the Seq 
column on the Edit Formatting display. 
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(— ~ 
Edit Break Footing 


Break Level)“: <r ie  es ie 2 


Type choices, press Enter. 


PUL OM TOW Page <<. we a ww aw em N Y=Yes, N=No 
Blank Vines before. . 4 « «4 ss 2% = 4 0 0-999, BOTTOM 
Bllank:line@Ss:abter <2: eects ese ase 3) is 0-999 
Put break summary at line ........ (a 1-999, NONE 
Break text: Use &col to cause variable insertion. ey, 
Figure 70. Edit Break Footing Display 
Specifying formatting options for the report in Query Manager 
If you choose to specify formatting options from the Select Report Format display (see page 1114), Query 
anager shows the Specify Report Formatting Options display. An example of this display is shown in 
ia =) 
Specify Report Formatting Options 
Type choices, press Enter. 
Detail Iine=spacing® «2s 3 i Sees 1 1-4 
Outlining for break columns ..... if Y=Yes, N=No 
Default break text 20. 2. 0c ss ue ¥ Y=Yes, N=No 
Column wrapped lines kept on page .. Y Y=Yes, N=No 
Column heading separators ...... if Y=Yes, N=No 
Break summary separators ....... Y Y=Yes, N=No 
Final summary separators ....... Y Y=Yes, N=No 
F2=Alternate keys F3=Exit F5=Run report  F12=Cancel F13=Edit query 
F18=Display SQL F22=QM statement 
XN yy 
>) 
F2=Base keys F3=Exit F5=Refresh F12=Cancel F13=Edit query 
eee Shy SQL F22=QM statement y 


Figure 71. Specify Formatting Options Display 


Use this display to enter the following information to specify the formatting for your report. 
* Detail line spacing 


Specify the spacing between one detail line and the next within the report. Type a value between 1 and 
4, where 1 is single spacing, 2 is double spacing, and so on. 


* Outlining for break columns 


Type N (to suppress outlining) if you want the value in the break column to appear on every detail line 
of the report, or Y (to enable outlining) if you want the break value to appear only when it changes. This 
affects the report only if you have specified breaks (see page L122). 
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For example, in Figure 3 on page 7) Department has been used as a break column. When the 
department number changes from 20 to 38, a break occurs. Outlining has been used, and the 
department number is printed only for the first line in each group of detail lines. 

Default break text 

This prompt affects only those break levels where you specify the position within the break footing at 
which you want summary data to appear, but you do not enter any break footing text. You position 
break summary data and enter break footing text through the Edit Break Footing display, which is 


described in 
Default break text is one or more asterisks that indicate the level of the break. The lowest level break 
(that is, the break with the highest number) has one asterisk, the next lowest level break has two 
asterisks, and so on. Asterisks are right justified so they appear immediately to the left of the first 
column that has summary data. 

For example, if the report has two breaks, BREAK1 and BREAKS, one asterisk appears beside the 
summary data at each level-3 break, and two asterisks appear beside the summary data at each level-1 
break. 

Column-wrapped lines kept on page 

If you specify line wrapping for any of the columns in the report (by selecting an edit code of CW, CT, or 
GW through the Edit Column Formatting display), this prompt determines whether the column data can 
be split over more than one page. Type Y if you want to keep the column information on a single page, 
or N to split the information over multiple pages if necessary. 

Column heading separators 

Type Y if you want separators (dash lines) to appear under each column heading in the report, or type 
N if you want to suppress the separators. 


Break summary separators 


Type Y if you want separators (dash lines) to appear above any summary data at each report break, or 
type N if you want to suppress the separators. 


Final summary separators 


Type Y if you want separators (equal signs) to appear above any final summary data at the end of the 
report, or type N if you want to suppress the separators. 


Copying a report form in Query Manager 


When you copy a report form, you can create a new report form or replace an existing one. 


1. 


Type 2 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Report Forms display. 


Type 3 in the Opt prompt next to the names of the report forms you want to copy; then press the Enter 


key to go to the Copy Report Form display. This display lists the names of all of the report forms you 
specified. An example of the Copy Report Form display is shown in Figure 72 on page 134 
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(& ~ 
Copy Report Form 
Rrom iibrany <a aoe 3 IMYLTB 
Type information, press Enter: 
MO? MAD WARY se: > ces ene, sen ted Soe MYLIB Name 
RepiliaGe:sfonm sesso sp ee. es N Y=Yes, N=No 
To rename copied form, change To Form name. 
From Form To Form 
VENDINFO VENDINFO___ 
Bottom 
F3=Exit F5=Refresh  F12=Cancel F22=QM statement 
Ne p/ 


Figure 72. Copy Report Form Display 


3. 


Before you can copy a report form, you need to specify the following information. If you are copying 
more than one report form, all report forms are copied using the same settings. 


* To library. Type the name of the library to which you want the report form copied. 

* Replace form. Type Y if you want to replace an existing report form, or N if you want to create a 
new report form. The default is N. 

Type the name of the report form you want to create or replace in response to the “To Form” prompt. If 

you answered N to “Replace form”, the name you type cannot already exist in the specified library. 

Report form naming conventions are described on page BL. 

Press the Enter key to perform the copy and return to the Work with Query Manager Report Forms 


display. If you want to leave the Copy Report Form display without copying any report forms, press F3 
(Exit) or F12 (Cancel) instead of the Enter key. 


Deleting a report form in Query Manager 


When you choose to delete a report form, Query Manager shows a confirm display. No report forms are 
deleted until you respond to this display. 


le 


Type 2 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Report Forms display. 

Type 4 in the Opt prompt next to the names of the report forms you want to delete; then press the 
Enter key to go to the Confirm Delete of Report Form display. This display lists the names of all of the 
report forms you selected to delete. An example of this display is shown in 
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Confirm Delete of Report Form 
Library “2 ee are hee es MYT 


Press Enter to confirm your choices for 4=Delete. 
Press Fl2 to return to change your choices. 


Opt Form Description 
4 MY FORM Example form for DB2 UDB for iSeries Query Manager 


Bottom 


Fll=Display form only — F12=Cancel 


Figure 73. Confirm Delete of Report Form Display 


When you choose to delete more than one report form, you may want to press F11 (Display form only) 
to hide the report form descriptions and show multiple columns of report form names on the display. 


3. Press the Enter key to confirm the delete and return to the Work with Query Manager Report Forms 
display. Note that when you press the Enter key, you delete all of the report forms shown on the 
display. If you want to leave the display without deleting any report forms, press F12 (Cancel) instead 
of the Enter key. 


Displaying a report form in Query Manager 


You can view the definition of a report form in displays that are similar to the Select Report Format 
displays through which the report form is defined. This information is shown in display-only format. You 
cannot change any values through this option. 


1. Type 2 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Report Forms display. 

2. Type 5 in the Opt prompt next to the names of the report forms whose definitions you want to view; 
then press the Enter key to go to the Display Report Format display. This display is shown for the first 
report form you specified. Display Report Format displays for the remaining report forms are shown in 


the same order as the report form names appear in the “Work with” display list. An example of the 
Display Report Format display is shown in Pou cnpage iad 
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Display Report Format 
FOnM Es, ce cusses: :  MYFORM 
Type options, press Enter. Press F21 to select all. 
1=Select 
Opt Report Format 
ae Display column formatting 
< Display page heading 
= Display page footing 
= Display final text 
a Display break text 
= Display formatting options 
Bottom 
F3=Exit F5=Run report F12=Cancel F13=Display query F18=Display SQL 
F21=Select all F22=QM statement 
XN 
Figure 74. Display Report Format Display 
3. Type 1 in the Opt prompt next to the parts of the report form that you want to display; then press the 
Enter key. You can choose to display all parts by pressing F21 (Select all). Displays for the parts you 


choose are shown in the same order as the part names appear on the Display Report Format display. 
When you finish viewing one display, press the Enter key to go to the next display. When you finish 
viewing all of the parts you selected, press the Enter key to return to the Display Report Format 


display. 

a ee find descriptions of the report form parts on the following pages: 
Column formatting page 

Page heading page 1124 

Page footing page hod 

Final text page hoa 

Break text page had 

Formatting options page had 


4. You can perform the following tasks through this display: 


¢ Press the F5 key to run or display the report. The title of the F5 key changes depending on the 


active data: 


Note: For the active data to match the active form, they both need to contain the same number of 
columns, and the columns need to have compatible data types. Active data is described on 


If F5 is labeled (Display report) or (Display sample), the report form is applied to the active data, 
and the resulting report is shown on your display. If F5 is labeled (Run report), the Run Query 


If the active data is the result of running a full query, the key is labeled (Display report). 
If the active data is the result of running a sample query, the key is labeled (Display sample). 
If there is no active data, or if the active data does not match the report form, the key is labeled 


(Run report). 


page I. 
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display is shown, prompting you to specify run options such as the name of the query you want to 
run, and the mode in which you want to run the query. The Run Query display options are described 
on page 

* View the SQL statement that defines the active query. Press F18 (Display SQL) to view the query 
statement in display-only format. If there is no active query, an error message is shown. 


When you choose to (Display SQL) for a prompted query, the SELECT statement is shown with 
descriptive comments, in the same format as prompted query definitions are printed. See 
car for an example of the format in which the SQL statement is presented. 


When you finish viewing the query definition, press F12 (Cancel) to return to the Display Report 
Format display. 


* View the definition of any query. Press F13 (Display query) to view the definition of a query. A 
prompt display is shown, asking you to type the name of the query you want to display. Type a 
name, or press F4 (Prompt) to display a list of the queries in the current library from which you can 
make a selection. The query definition is shown in the mode in which the query was last saved: 
either prompted or SQL. See ED 9 for more 
information. 


When you finish viewing an SQL query definition, press F13 (Display form) to return to the Display 
Report Format display. When you finish viewing a prompted query definition, type 1 in the Opt 
prompt beside “Specify report formatting” on the Define Prompted Query display. Then press the 
Enter key to return to the Display Report Format display. 


5. When you finish viewing the report form, press F3 (Exit) or F12 (Cancel) to return to the Work with 


Query Manager Report Forms display. 


Printing a report form in Query Manager 


You can print the formatting information that defines the report form on the default printer specified in your 
Query Manager profile. 


1. 


Type 2 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Report Forms display. 

Type 6 in the Opt prompt next to the names of the report forms whose definitions you want to print; 
then press the Enter key to send the report form definitions to your default printer. To print the 
definition at a different printer, you need to change the ae al setting in your Query Manager 
profile before you choose to print the report form. See page 42. 

If you choose to print more than one report form, the report forms are printed in the same order as 
their names appear in the “Work with” display list. 


A message at the bottom of the display tells you when the report forms have been successfully sent to 


print. (All report form definitions are printed interactively.) The printer file is named QPQXPRTF. An 
example of a printed report form is shown in ; 
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Query Manager Page 1 


5763ST1 V3RIMO 940415 ABC400A 94/04/15 16:38:22 

Form. ..... . :  MYFORM 
Library ....: MYLIB 

Text... .. .. : Example Report for DB2 UDB for iSeries Query Manager 

Column Information 

Nbr Heading Usage Type Indent Width Edit Seq 
1 Department BREAK1 0 1 
2 Emp]oyee_Name 2 2 
3 Job BREAK2 2 3 
4 Salary SUM 2 4 
5 Commission SUM 2 5 

Page Information 

Heading text ... 1... 6. 2 ee eee ee s~=6©NO 

Blank lines before heading ........: O 

Blank lines after heading. ........: 2 

FOOUINGCEXT. oe: ei. Ge eeu olde ee a a ge ee NO 

Blank lines before footing ........: 2 

Blank lines after footing. ........: 0 

Final Information 

Fail “COXG: iw: wee an ee ee Sw A ee ee a eee MES 

New page for final text. .........: = 41N0 

Put final summary at line. ........: 2 

Blank lines before text ..........: 0 


Line Align Final Text 
1 LEFT Grand total -- 
2 ~~ LEFT Employee Salaries 
Break Information 


Break number «ss 6 6 & @ 6 we ew we we we 8 il 
Columns with this break number ......: 1 
Heading text ........6244422--2 23: ~ 40ND 
New page for heading ...........:~ &42N0 
Blank lines before heading ........: O 
Blank lines after heading. ........: 0 
Repeat column headings ..........: =~ #4NO 
FOOCING: COXE Senter seo wet ee we Ae a ee ee YES 
New page for footing ...........:~ &4,N0 
Blank lines before footing ........: 0 
Blank lines after footing. ........: 1 
Put break summary at line. ........32 1 


Line Align Footing Text 
1 RIGHT Total for department &1; 


Figure 75. Example of a Printed Report Form 


Renaming a report form in Query Manager 


You can specify new names for more than one report form in a single operation. 


1. Type 2 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Report Forms display. 


2. Type 7 in the Opt prompt next to the names of the report forms you want to rename; then press the 


Enter key to go to the Rename Report Form display. This display lists the names of all of the report 
forms you specified. An example of this display is shown in Poue7a on paca dail 
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Rename Report Form 
[Rilo teN haste arr eautrrgrch oeecccsecieraece elnih Els) 


To rename form, type New Name, press Enter. 


Form New Name 
VENDINFO VENDINFO___ 

Bottom 
F3=Exit F5=Refresh F12=Cancel F22=QM statement 


Figure 76. Rename Report Form Display 


3. Type the new name for the report form. Report form naming conventions are described on page bd. 
You need to enter a report form name that does not already exist in the current library. You cannot use 
the rename option to replace existing report forms. 


If you choose to rename more than one report form, you need to type new names for all of the report 
forms before pressing the Enter key. 


4. Press the Enter key to perform the rename and return to the Work with Query Manager Report Forms 
display. If you want to leave the Rename Report Forms display without renaming any report forms, 
press F3 (Exit) or F12 (Cancel) instead of the Enter key. 


Running a report in Query Manager 


When you run a report, Query Manager runs an SQL SELECT statement query or prompted query, and 
formats the query data using the specified report form. You can run an SQL SELECT statement query only 
if you have authority to use the SELECT statement (granted through your Query Manager profile). 


1. Type 2 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Report Forms display. 


2. Type 9 in the Opt prompt next to the names of the reports you want to run; then press the Enter key to 
go to the Run Query display. The Run Query display is shown for the first report you specified. Run 
Query displays for the remaining reports are shown in the same order as the report form names 
appear in the “Work with” display list. 


Note: You can specify in your Query Manager profile whether you want run options to be displayed. 
This setting applies only when you run a report as the result of pressing a function key. Run 
options are always displayed when you run a report through a “Work with” display. 


3. Specify the run options you want Query Manager to use when the report is run. Run options are 


with &) in the query, Query Manager prompts you to enter a value for each variable before the query is 
run. The values you enter are substituted into the query when it is run. 


The report is run using the options you specify on the Run Query display. 
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Note: When a report is run in interactive mode, the number of rows retrieved by the 


If the report was submitted to batch, the Work with Query Manager Report Forms display is shown 
ready for you to perform the next task. 

If the report was run interactively and the output sent to a printer or table, you need to wait for the 
report to complete running before the Work with Query Manager Report Forms display is shown. 


If the report was run interactively and the output sent to display, you see the results of the query 
and report form shown on your display when the report completes running. Press F3 (Exit) or F12 
(Cancel) when you want to leave the display and return to the Work with Query Manager Report 


Forms display. 


query might be 


there are more rows to be relieved all final summary data is omitted from the report, and a 
message is shown telling you that the report data is incomplete. 
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Chapter 7. Running queries and reports in Query Manager 


This chapter describes the different ways in which you can run queries and reports. You can run any 
prompted query, and only those SQL queries that contain one of the SQL statements you have authority to 
use (granted through your Query Manager profile). When you run a report, Query Manager runs the 
specified SQL SELECT statement query or prompted query, and formats the resulting data using the 
specified report form. 


You can run queries and reports while you are creating query and report form definitions, to make sure 
that the definitions are producing the results you require. Query Manager validates the definitions before 
performing the run. You can also run existing queries and reports that you did not create. 


This chapter begins with a description of the different ways in which you can run queries and reports. It 
then explains how you can specify run options, such as the mode in which you want to run the query or 
report and the destination to which you want the output directed. Following that are instructions on how to 
use the special function keys that are available when you send your query or report output to display. 


Running a query or report in Query Manager 


When you run an SQL SELECT statement query, a prompted query, or a report, Query Manager runs the 
specified query and formats the resulting data using the specified report form. 


To run a query, you need to have access to the library in which the query resides, and access to the 
libraries or collections in which the tables being queried reside. If you want to format the query data using 
a report form, you need to have access to the library in which the report form resides. 


Note: To run an SQL query, you need to have authority to use the SQL statement that defines the query. 
Authority to use SQL statements is granted through your Query Manager profile. See ESalactind 
C for details.) 


Users with a BASIC or ALL access level can run queries and reports in the following ways: 
¢ By choosing option 9 (Run) from the Work with Query Manager Queries display. See page 64. 
° a option 9 (Run report) from the Work with Query Manager Report Forms display. See page 


. By Pressing F5 (Run report) or F6 (Run sample) while they are displaying a query definition. See page 


* By pressing F5 (Run report) while they are displaying a report form definition. See page i371 


Users with an ALL access level can run queries and reports in the following additional ways: 

¢ By pressing F5 (Run report) or F6 (Run sample) while they are creating or changing a query definition. 
See page Gd 

* By pressing F5 (Run report) while they are creating or changing a report form definition. See page fi. 

* By entering the RUN QUERY statement on the Query Manager statement line. See page B59. 


Running a query in batch mode in Query Manager 


You cannot run a query in batch mode if it has not yet been named and saved. Query Manager shows the 
Exit display, and will not submit the query to batchuntil it has been named and saved. See Saving d 
‘ 07 for instructions. 


Any changes made to the query since it was last saved are included if you run the query in interactive 
mode, and ignored if you run it in batch. If you run the query in batch, a message tells you that the most 
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recently saved version of the query is being run. When you return to the query editor, your changes are 
still there. Running the previously saved version in batch mode has no effect on the version of the query 
you are editing. 


Specifying run options in Query Manager 


The options that you are prompted to specify when you run a query or report differ depending on the 
settings in your Query Manager profile, and the way in which you chose to run the query or report: 


¢ When you run a query by choosing option 9 (Run) from the Work with Query Manager Queries display, 
the Run Query display is always shown if the query is an SQL SELECT statement or a prompted query. 


¢ When you run a query by pressing F5 (Run report) or F6 (Run sample) while you are creating, 

changing, or displaying a query definition, the Run Query display might be shown if the query is an SQL 

SELECT statement or a prompted query: 

— If the “Display run options” setting in your Query Manager profile is YES, the Run Query display is 
shown. 

— If the “Display run options” setting in your Query Manager profile is NO, the Run Query display is not 
shown. The query is run using the active form and the default settings from your Query Manager 
profile. 


Note: A Run Query display is shown if the active query does not match the active form. For the 
active query to match the active form, they need to have the same number of columns, and 
the columns need to have compatible data types. 


e When you run a query by entering the RUN QUERY statement on the Query Manager statement line, 
no run options display is shown. The query is run using the options you specify as part of the RUN 
QUERY statement, and the default settings from your Query Manager profile. 

¢ When you run a report by choosing option 9 (Run report) from the Work with Query Manager Report 
Forms display, the Run Query display is always shown. 

* When you run a report by pressing F5 (Run report) while you are creating, changing, or displaying a 
report form definition, the Run Query display is always shown. If the F5 key is labeled (Display report) 
or (Display sample), no run options display is shown. The report is produced using the active data, and 
output to display. 


Using the Run Query display is described on page [144] 


Using the run query display in Query Manager 

Use the Run Query display to specify the way in which you want the query or report to be run. You can 
change any of the run options shown on this display. The default run options are taken from your Query 
Manager profile. 


The prompts shown on the Run Query display differ depending on whether you are running a query or 
report. 


You run a query by choosing option 9 (Run) from the Work with Query Manager Queries display, or by 
pressing F5_(Run report) or F6 (Run sample) while you are creating, changing, or displaying a query 
definition. is an example of the Run Query display shown when you run a SELECT 
query. is an example of the Run Query display shown when you run a query other 
than a SELECT query. 
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Run Query 
Query «2 3% = :  MYQUERY 
iabrary 25,4033: JMYLIB 
Type choices, press Enter. 
Run query mode... I 1=Interactive 
2=Batch 
Run sample only .. WN Y=Yes, N=No 
FONMien opus tout ce wus *SYSDFT____ Name, *, *SYSDFT, F4 for list 
Eqbrary? fs se Name, *CURLIB, *LIBL 
QUEpUE SS as poe ee 1 1=Display, 2=Printer 
3=Table 


F3=Exit F4=Prompt  F12=Cancel 


S 
Figure 77. Run Query Display for SELECT and Prompted Queries 
= 
Run Query 
QUERY fn Sse :  MYQUERY 
Library” Vs cs.ea ccc) AMV ETB 
Type choices, press Enter. 
Run query mode... I 1=Interactive 
2=Batch 
F3=Exit F4=Prompt  F12=Cancel e 


Figure 78. Run Query Display for Queries Other than SELECT Queries 


You run a report by choosing option 9 (Run report) from the Work with Query Manager Report Forms 


display, or press F5 a report) while you are creating, changing, or displaying a report form 
definition. is an example of the Run Query display shown when you run a report. 
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Run Query 
FOWM sc) 2m srs: <r os :  MYFORM 
Library 4.09.4)  MYETB 
Type choices, press Enter. 
Run query mode... 1 l=Interactive 
2=Batch 
Use active data .. ¥ Y=Yes, N=No 
Run sample only .. WN Y=Yes, N=No 
QUETV iF cep enet rec nee aes * Name, *, F4 for list 
Wei aye cesee cep eens Name, *CURLIB, *LIBL 
QUEDURS eres, ieee 1 1=Display, 2=Printer 
3=Table 


F3=Exit F4=Prompt  F12=Cancel 


Figure 79. Run Query Display for Reports 
Specify the values that you want Query Manager to use when the query or report is run. 


Run query mode in Query Manager 

Type 1 for interactive mode if you want the query to run as soon as you press the Enter key. Use 
interactive mode when you want to create active data, run a sample query, or send the query output to 
display. 


Type 2 for batch mode if you want your query submitted to batch. Use batch mode to free your display 
station immediately after you press the Enter key (to issue the RUN statement). 


See page 38] for more information on batch and interactive modes. 


Notes: 


1. If “Allow change run query mode” is set to NO in your Query Manager profile, this prompt is 
display-only and cannot be changed. 


2. When a query is run in interactive mode, the number of rows retrieved might be limited by your Query 


Manager profile (see x 
ae. If the maximum number of rows has been reached but ‘hers are more rows to be retrieved, 
all final summary data is omitted from the report, and a message is shown telling you that the data is 
incomplete. 

3. You cannot run an unnamed query or report form in batch mode. When you run a query or report form 
you are creating that you have not yet saved or named, the Exit display is shown. Save and name the 
query or report form, or choose to perform the run in interactive mode. 


Run sample only in Query Manager 
Type Y to limit the number of rows retrieved by the query to the value specified for “Number of rows to use 
for sample” in your Query Manager profile (see page 39). Type N if you want to run a full query. 


Sample queries are useful when you want to create active data, but do not want to wait for a full query to 
complete running. Sample queries are always run in interactive mode and output to display. Note that you 
can run sample queries only if “Allow interactive sample run” is set to YES in your Query Manager profile 
(see page Ba) 
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Report form and library in Query Manager 

If you are running an SQL SELECT statement query or a prompted query, you are prompted to specify the 
name of the report form you want to use to format the query data, and the name of the library in which it 
resides. Choose one of the following: 


. Use the active form. This is the default, available only when there is an active form. Leave 
the library name blank. 


*SYSDFT Use a simple report form, generated by Query Manager when the query is run. This is the 
default when there is no active form. Leave the library name blank. 


name Use an existing report form. Type the name of a report form and the library in which it 
resides, or press F4 (Prompt) to display a list of all report forms in the current library from 
which you can make a selection. If you do not enter a library name, Query Manager uses 
the “Default library for QM objects” specified in your Query Manager profile. 


Query and library in Query Manager 
If you are running a report, you are prompted to specify the name of the query you want to run to generate 
the query data, and the name of the library in which it resides. Choose one of the following: 


: Use the active query. This is the default, available only when there is an active query. Leave the 
library name blank. 


name_ Use an existing query. Type the name of a query and the library in which it resides, or press 
F4 (Prompt) to display a list of all queries in the current library from which you can make a 
selection. If you do not enter a library name, Query Manager uses the “Default library for QM 
objects” specified in your Query Manager profile. 


blank Leave the query and library names blank, and specify to run the report using the active data. This 
option is available only when there is active data. 


Use active data in Query Manager 

Type Y to produce the report by applying the specified report form to the active data. Leave the prompts 
for query name and library name blank when you answer Y to this prompt. This prompt is shown only 
when there is active data. 


Active data is the data that resulted from the last SQL SELECTstatement query or prompted query that 
was run interactively during the current Query Manager session. 


Output in Query Manager 

Type 1 to send the query output to your display station, type 2 to send the output to a printer, or type 3 to 
write the output to a fable. You can send the output to display only when the query is run interactively. You 
need to send the output to display when you run a sample query. 


If you specified an output destination of printer or table, press the Enter key to display additional prompts 
for the printer name, or the table and collection names. 


Printer to use for output in Query Manager 

If you specified to send your output to a printer, you are prompted to enter the ID for the OS/400 output 
queue or printer that you want to use. Press F4 (Prompt) to view a list of all supported IDs from which you 
can make a selection. The default is the output queue or printer ID specified in your Query Manager 
profile. 


Table to use for output in Query Manager 

If you specified to send your output to a table, you are prompted to enter the name of the table, and the 
collection in which it resides. Press F4 (Prompt) if you want to view a list of all tables in the current 
collection from which you can make a selection. 
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The default is the output table and collection specified in your Query Manager profile. If the default table is 
*NONE, you need to enter a table name before the query is run. If the default collection is blank, Query 
Manager searches the “Default library for QM objects” specified in your Query Manager profile. 


Note: The collection name you specify must exist on your local iSeries system. Even if you are connected 
to a local database, the table is always saved to your local iSeries system. Therefore, you should 
run the query or report in batch mode. 


Displaying query output in Query Manager 


When you_choose to send your query output to display, the report is shown in a display similar to the one 
shown in . Note that page headings defined through a report form appear only when the report is 
printed. When you send your output to display, the first line shown in the report is the column headings. 


(a \ 
Display Report 
Query... .. :  MYLIB.SMPQRY Width: «3% 3 71 
FORM rar- ess es Column ..: 1 
Control ee sauces 
IMG pace chivvwielalncech somneit tavetomertolsratane ele erate tea aiereckis tom serectiere iedes 
ID NAME DEPT JOB YEARS SALARY COMM 
000001 10 Sanders 20 Mgr 7 18,357.50 00 
000002 20 ~=—Pernal 20 ~=Sales 8 1B A725: 612.45 
000003 30  Marenghi 38 Mgr 5 17,506.75 00 
000004 40 O'Brien 38 =Sales 6 18,006.00 846.55 
000005 50 Hanes 15 Mgr 10 20,659.80 00 
000006 60 Quigley 38 =Sales 0 16,808.30 650.25 
000007 70 Rothman 15 Sales 7 16,502.83 1,152.00 
000008 80 James 20 =Clerk 0 13,504.60 128.20 
000009 90 Koonitz 42 Sales 6 18,001.75 1,386.70 
000010 100 = Plotz 42 Mgr 7 18,352.80 00 
000011 110 Ngan 15 Clerk 5 12,508.20 206.60 
000012 120 Naughton 38 = Clerk 0 12,954.75 180.00 
000013 130 Yamaguchi 42 Clerk 6 10,505.90 75.60 
000014 140 ~=~Fraye 51 Mor 6 21,150.00 -00 
More 
F3=Exit F12=Cancel Fl9=Left F2Q=Right F21=Split 


Figure 80. Display Report Display 


This display provides special function keys that you can use to view the entire report if it is more than one 
display in width. 


F21 Split. Splits the report into two displays vertically at the current cursor position. Move the cursor to 
the column at which you want to split the report; then press F21. Note that the cursor needs to be 
positioned on the column data, not on the column heading. 


F19 Left. Shows the columns that appear on the left-hand side of the report. If you defined a split, F19 
shows all columns to the left of the split. 


F20 Right. Shows the columns that appear on the right-hand side of the report. If you defined a split, 
F20 shows all columns to the right of the split. 


The Control prompt, shown above the columns of the report, also helps you view the entire report. 
Through this prompt, you can select and control paging, rolling, and window functions, and you can display 
a specific row from the report. Position the cursor on the Control prompt and press F1 (Help) for full 
instructions. 
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Leaving the display report display in Query Manager 

There are two ways in which you can leave the Display Report display: 

¢ Press F12 (Cancel) if you do not want the retrieved query data to become the active data. 
¢ Press F3 (Exit) if you do want the retrieved query data to become the active data. 


When you run a query interactively and direct the output to display, Query Manager runs the query one 
display at a time, so that the only part of the query that is run is the portion that you view. If you press 
F3 (Exit) to leave the display before you finish viewing all of the query data, an Exit display is shown 
asking whether you want to complete running the query. An example of this Exit display is shown in 


. sy 
Exit 
Type choice, press Enter. 
OptiOnme sa eee seven nes il 1=Exit saving active data 
2=Exit without saving active data 
3=Resume displayed report 
F12=Cancel 
By 


Figure 81. Exit from Display Report Display 


Choose one of the following options: 


1=Exit saving active data 
Choose this option when you want to finish running the query and save the retrieved data as 
active data. You need to wait for the query to complete running before you return to the display 
from which you chose to run the query or report. 


2=Exit without saving active data 
Choose this option to immediately return to the display from which you chose to run the query or 
report. The query does not complete its run and no active data is saved. 


3=Resume displayed report 
Choose this option to return to the Display Report display, where you can continue to view the 
data retrieved by the query. 

See page [8 for more information about active data. 

Date and time format considerations in Query Manager 


If you run a query that was saved with date and time formats that are different from those defined in your 


current job, the Confirm Run Query display is shown to warn you that the formats are not compatible. An 
example of this display is shown in Bae ao oa acid 
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Confirm Run Query 


Query <5 2s = :  MYQUERY 
IDRaRY io is ae en MYLIB 
WARNING 


The Query Manager query definition you have requested has a date format 
that is different from the date format used in your job. Dates 
displayed in the report may be in an unexpected format. 


If the query contains global variables, you need to enter the variable 
values for any dates using a date format of *USA, *ISO, *EUR, or *JIS. 
Entering dates in another format may cause an SQL failure. 


Job date format ..:  ¥*DMY Query date format .: ¥*MDY 
Job date separator . : : Query date separator: / 


Press Enter to continue. 
Press Fl2 to return without running the query. 


F12=Cancel 
S 


Figure 82. Confirm Run Query Display 


Press the Enter key to continue running the query, or F12 (Cancel) to return to the Work with Query 
Manager Queries display without running the query. 


If you choose to continue running the query, be careful if the query contains global variables. If any of 
these variables are dates, you need to enter the dates in a valid SQL format. When Query Manager runs 
the query, it translates the SQL date that you entered into the date format used by the query. Select one of 
the following formats: 


*DMY dd.mm.yyyy 31.10.1992 SQL format: EUR 
*MDY mm/dd/yyyy 10/31/1992 SQL format: USA 
*YMD yyyy-mm-dd 1992-10-31 SQL format: ISO/JIS 


Notice that the characters used to separate the different parts of the dates are different for all three of the 
formats. 


Note: Typing date variable values in a non-SQL format might cause an SQL failure. 


Running a query against databases from a previous release or 
non-iSeries databases in Query Manager 


Some sort sequence capabilities do not function correctly when you run them against remote databases 
that do not have the same sort sequence capabilities. This includes databases on: 

¢ Other than iSeries systems 

* iSeries systems at Version 2 Release 2 or earlier 


When the query uses a sort sequence other than *HEX, the Query Managerpresents the Confirm Run 
Query display (shown in igure 83) 
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Confirm Run Query 


Query «2 3 xs :  MYQUERY 
brary” 6 ss, ee MYLIB 
WARNING 


The Query Manager query definition you have requested uses a sort 
sequence table which is not supported on the remote relational database 
which you are connected to. The query can be run. No sort sequence 
table will be used when running this query or formatting the resulting 
report. Record selection, sorting and report processing may not give 
expected results. 


Sort sequence .... . : *LANGIDSHR 
Language identifier .. : ENG 


Press Enter to continue. 
Press Fl2 to return without running the query. 


F12=Cancel 


Figure 83. Confirm Run Query Display with Sort Sequence Warning 


If the query specifies a particular sort sequence table, the display shows the sort sequence table name 
and the library in which it resides. 


The warning in appears when the sort sequence is *LANGIDSHR, *LANGIDUNQ, or Sort 
sequence table. It also appears when the sort sequence is *JOBRUN and the job default sort sequence is 
other than *HEX. 


You can avoid this warning by changing the sort sequence to *HEX. 
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Chapter 8. Working with Query Manager tables 


This chapter describes Query Manager tables, and explains how you can create, maintain, and use them. 
You can add and change database information in your Query Manager tables, that can later be printed, 
viewed, and manipulated using the Tables, Queries, and Report Forms options. You create and maintain 
tables through Query Manager’s prompt-guided displays, which help to make this option simple to use. 


The chapter begins with some explanations and descriptions that you might want to read through before 
creating a table. It tells you what Query Manager tables are, and suggests where and when you might find 
these tables useful. 


Following the background information are instructions on how to use the options that are available through 
the Work with Query Manager Tables display. You can learn how to create, copy, delete, rename, and 
display a table; and how to add, change, search for, display, and print rows of data. 


Note: Your access to the Work with Query Manager Tables display might be restricted through your Query 
Manager profile. If “Allow access to QM tables option” is set to NO, the (Work with Query Manager 
tables) option is not shown in the main menu, and you cannot access the Work with Quer 
Manager Tables display. See on page 44 for more 
information. 


What Are Query Manager tables? 


Query Manager tables contain database information that you can add to, manipulate, format, and view. All 
Query Manager users can create tables and add information to them. This information can later be viewed, 
printed, and manipulated through the Tables, Queries, and Report Forms options. 


Use Query Manager tables to store information such as: 

* The results from your latest marketing survey 

* The targets and current sales figures for all sales staff in your department 
¢ Your available supplies on hand 


If you want to store confidential information in your tables, see your security administrator about setting up 
an *EXCLUDE authority for the collection or library in which your tables are stored. The “EXCLUDE 
authority stops other users from being able to access the information in your tables unless you specifically 
grant them access privileges, so your confidential information is secure. 


You can access tables that were created outside Query Manager through the Work with Query Manager 
Tables display, as long as the tables are in a collection or library to which you have access, and as long 
as they contain only those data types that are supported in Query Manager. A list of supported data types 
can be found on page 


Each Query Manager table is named by the person who creates it. The following table is named “ORG”. 


Table 10. The ORG Table 


DEPTNO | DEPTNAME MANAGER | DIVISION LOCATION 
10 | Head Office 160 | Corporate New York 
15 | New England 50 | Eastern Boston 
20 | Mid Atlantic 10| Eastern Washington 
38 | South Atlantic 30 | Eastern Atlanta 
42 | Great Lake 100 | Midwest Chicago 


© Copyright IBM Corp. 1998, 2002 
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Table 10. The ORG Table (continued) 


DEPTNO | DEPTNAME MANAGER | DIVISION LOCATION 
51 | Plains 140 | Midwest Dallas 
66 | Pacific 270 | Western San Francisco 
84 | Mountain 290 | Western Denver 


A table consists of vertical columns and horizontal rows. Each column has a name which you use to refer 
to information in the table. The column names in the ORG table are DEPTNO, DEPTNAME, MANAGER, 
DIVISION, and LOCATION. A row is a sequence of values, one for each column of the table; it is a group 
of related data treated as a unit. 


You can find a more detailed description of tables, columns, and rows in the introduction to this User 
Guide, see [‘Databa 


Using the work with Query Manager tables display 


When you want to create, copy, print, or use a Query Manager table in any way, the Work with Query 
Manager Tables display is the place to begin. 


You select the Work with Query Manager Tables display from the Query Managermain menu. Type 3 in the 
Selection prompt; then press the Enter key to go to the Work with Query Manager Tables display. An 
example of this display is shown in igure aal 


Ve = 
Work with Query Manager Tables 


Epil) celle age wereeerncen erence tes tireech a MYCOLL Name, F4 for list 

Type options, press Enter. 
1=Create table 3=Copy table 
6=Print table 7=Rename table 


10=Change data  11=Display data 


4=Delete table 
8=Display definition 


5=Display table 
9=Add data 


Opt Table 
1 STAFF. 
JOB_APPLICANT_LIST Table of job applicants 
LONG_TABLE_NAME_IS > Sample CARS Table 

EMPLOYEE Personnel in each in each department 
ORG Corp.'s organization information 


Description 


____ PRODUCT Description of corp. products 
__ SCREENS Output file for STRCPYSCN 
___VENDINFO Vendor Information 
Bottom 
F3=Exit F4=Prompt F5=Refresh Fl1l=Display table only  F12=Cancel 
Fl6=Repeat position to F17=Position to F24=More keys 
Ne ay 
; > 
F20=Display entire name F22=QM Statement F24=More keys 
ey 


Figure 84. Work with Query Manager Tables Display 


The tables listed on this display are those stored in the collection shown at the top of the display. If you 
have an ALL access level, the collection name is underlined, indicating that it is a prompt value. You can 
type a new collection name over the existing name if you want to access the tables from a different 
collection. Position the cursor on the Collection prompt, and press F4 (Prompt) to display a list of 
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collections from which you can make a selection. You need to have *CHANGE authority for the collection 
that you specify if you want to use all options available through the Work with Query Manager Tables 
display. 


Notes: 


1. The Query Manager tables option works with local data only. If you are using a remote database 
connection when you select to work with tables, Query Manager stores the details; then breaks the 
connection. The connection is restored when you exit from the Tables option. For more information on 


2. You cannot issue the CONNECT, or SET CONNECTION statements while you are working with Query 
Manager tables. 

3. It is recommended that you not issue the DISCONNECT or RELEASE statements while you are 
working with Query Manager tables. 

4. You cannot work with Query Manager ells if you have any COMMIT or ROLLBACK statements 
outstanding (see }). Once you go to the Work 
with Query Manager Tables display, aun Managerignores your cammiltment control level, and issues 
COMMIT statements for all data and updates automatically. 

5. When in WORK WITH TABLES, the connection is locked to local and cannot be changed by the 

CONNECT or SET CONNECTION statements. The local or previous connection can be aeee ed 


You can choose any of the following options to work with a table. 


1=Create table 
Creates a Query Manager table. Query Manager prompts you to specify the name, data 
type, length, and number of decimal places for all of the columns you want to include in 
the table. See page 


3=Copy table Copies a table. You can replace an existing table or create a new one. You can make an 
exact copy of the table definition, or you can make modifications to the definition before 
the copy occurs. You can also choose to copy the table definition only, or to copy the 
definition and the table data. See page 


4=Delete table 
Deletes tables you no longer require. You need to respond to a confirm display before the 
delete occurs. See page i 74 


5=Display table 
Displays a report, showing selected rows from a table on your display. You are prompted 
to specify search conditions. Only those rows that match the search conditions are 
displayed. If you do not specify search conditions, all rows from the table are displayed. 
See page irzz| 


Note: This option is not available if you are running Query Manager in batch mode. See 


6=Print table Prints a report, showing selected rows from a table on your default printer. You are 
prompted to specify search conditions. Only those rows that match the search conditions 
are printed. If you do not specify search conditions, all rows from the table are printed. 
See page ia 


7=Rename table 
Prompts you to specify a new name for existing tables. See page 7d. 

8=Display definition 
Shows the definition of a table in display-only format. You cannot change any values 
through this option. See page 
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9=Add data Shows a data entry display through which you can add row data to a table. See page 63) 


10=Change data 
Prompts you to select specific rows from a table. These rows are then shown, one ata 
time, in a data entry display. You can either change the row data (by typing new values 
over the existing ones), or you can delete the row from the table. See page 5 


11=Display data 
Prompts you to select specific rows from a table. These rows are then shown, one ata 
time, in a display similar to the data entry display. The row information is shown in 
display-only format. You cannot change any values through this option. See page F 


If you need help selecting tables from the “Work with” display, see page id. if you need help using the 
“Work with” display function keys, see page ba. 


Specifying a collection for Query Manager tables 


If the “Default collection for QM tables” setting in your Query Manager profile is *VONE (see page Li), you 
need to specify a collection or library before you can start to work with tables. When you select to Work 
with Query Manager Tables from the Query Manager main menu, you see a prompt window similar to the 
one shown in Figure a asking you to specify a collection or library name. Type the name of the existing 
collection or library you want to use; then press the Enter key. 


a = 
DB2 Query Manager 05/400 
System: ABC400A 


Select one of the following: 


1. Work with Query Manager queries 
2. Work with Query Manager report forms 


Specify Collection or Library 
Type choice, press Enter. 


CGITeCTION: 4.3. wot) enw MYCOLL Name, F4 for list 


F4=Prompt F12=Cancel 


Selection 


Sige F12=Cancel F22=QM statement 


Figure 85. The Specify Collection or Library Window 


The Specify Collection or Library window is also shown if you do not have authority to use the collection or 
library specified in your Query Manager profile, or if the collection or library specified does not exist. 


Note: You need to have *CHANGE authority for the collection or library that you specify if you want to use 
all of the options available through the Work with Query Manager Tables display. If you specify a 
collection or library for which you have *USE authority, you cannot create or rename tables, and 
you can copy tables only if you have *CHANGE authority for the collection or library to which you 
are copying. 


You can create a new collection or library for Query Manager tables through the Work with Query Manager 
Profiles option. See [Defau for more information. 
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Creating a table in Query Manager 


Creating tables is easy using the prompt-guided Create Query Manager Table display. You are prompted 
to specify the name, data type, length, and number of decimal places for all of the columns you want to 
include in your table. 


Note: You need to have *CHANGE authority for the current collection to create a table through Query 
Manager. 

1. Type 3 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Tables display. If you do not have a “Default collection for QM tables” 
specified in your Query Manager profile, you are prompted to specify the name of the collection you 
want to use (See page ; 

2. Type 1 in the Opt prompt next to the blank table name (at the top of the list) 


3. Name the table by doing one of the following. (For more information on how to name tables, see 


a. If you want the name to be no longer than 18 characters, type the name. 
b. Press the Enter key to show the Create Query Manager Table display. 
You can change the table name through this display, if desired, by typing over the existing name. 
Table naming conventions are described on page bd. 
c. If you want a table name longer than 18 characters, 
1) Leave the name blank. 
2) Press Enter to go directly to the Create Query Manager Table display. 
3) Use F20 to bring up the Display Entire Name display. 


% 
Create Query Manager Table 
Type choices, press Enter. 
Tia DCS see se ison srvcnesaesaery. Name 
Table Name 
Type information, press Enter. 
Ta DCCs eee as 
Bottom 
F6é=Insert line F10=Copy line F12=Cancel F14=Delete line 
F15=Split line 
Bottom 

F3=Exit F4=Prompt F5=Refresh F6é=Insert line F10=Copy line 
F12=Cancel Fl4=Delete line F19=Add data 24=More keys S, 


Figure 86. Display Entire Name display 


4) Type a name. 


The name can be up to 128 characters long not including quotes. The maximum length of the 
name including quotes is 258. 


Table naming conventions are described on page 
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An example of the CREATE QUERY MANAGER TABLE display is shown in Eigure 87. 


( ie 
Create Query Manager Table 
Type choices, press Enter. 
Table: “ss SS. see ee STAFF. Name 
DESCHIPUNON: te. stn ca Soe The STAFF Table 
Decimal 
Column Type Length Places 
ID CHAR 10 
Bottom 
F3=Exit F4=Prompt F5=Refresh F6=Insert line F10=Copy line 
F12=Cancel Fl4=Delete line F19=Add data  F24=More keys ey, 
; ; - 
Fl0=Copy line F14=Delete line F20=Display entire name 
ee aaa CREATE TABLE statement F24=More keys J 


Figure 87. Create Query Manager Table Display 


4. Type a description for the table (a maximum of 50 characters); then move the cursor to the first 
Column prompt to begin defining the table. 


5. Define the columns that you want to include in the table. (See page L150 for general information on 
defining table columns.) 


Specify the following information for each of the columns you want to define: 
* Column. A column name must begin with a letter and can be a maximum of 30 characters in length. 
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The first 18 characters can be entered directly on the Create Query Manager Table display. 
Additional characters can be entered using the Display entire name display. It cannot include any 
spaces. The name must be unique within the table being defined; columns in different tables can 
have the same name. 


For more information on how to name columns, see 


of all available data types from which you can make a selection. The data types that are supported 
for Query Manager tables are described on page 4 


Length. You need to specify a length for CHARACTER, VARCHAR, GRAPHIC, VARGRAPHIC, 
DECIMAL, NUMERIC, and FLOAT data types: 


— CHARACTER values can be 1 to 32765 characters in length. 
— VARCHAR values can be 1 to 32739 characters. 

— GRAPHIC values can be 1 to 16383 characters. 

— VARGRAPHIC values can be 1 to 16370 characters. 

— DECIMAL and NUMERIC can be a maximum of 31 digits. 

— FLOAT can be a maximum of 53 digits. 


DB2 UDB for iSeries Query Manager Use V5R2 


All other data types have set lengths. If you specify a length for a set length data type, Query 
Managerdisplays an error message. 


* Decimal Places. If the data type is NUMERIC or DECIMAL, you need to specify the number of 
decimal places. Type a number between 0 and the length you specified for the column, 
remembering that the maximum number of digits for both of these data types is 31. 


When you create a table, you can insert, copy, and delete lines using the F6 (Insert line), F10 (Copy 
line), and F14 (Delete line) function keys. These function keys are described on page 223. 


6. When you finish defining all of the table columns, press the Enter key to save the table definition. If 
you want to exit without saving the definition, press F3 (Exit) or F12 (Cancel) instead of the Enter key. 


Query Manager will not save a table that contains column definitions that are not valid. For example, 
you cannot specify a CHARACTER data type with decimal places. If Query Manager finds any errors 
when you try to save the table, it highlights the values that are not valid, and shows messages at the 
bottom of the display telling you how to correct each entry. 


When the table is saved, you see a message at the bottom of the display saying, “Table successfully 
created. Press F19 to add rows.” Press F19 (Add data) if you want to begin adding data rows to the 
newly created table. This function key works in the same way as if you chose 9 (Add data) from the 
Work with Query Manager Tables display. See page 1.69] for instructions. 


7. When you finish creating (and adding data rows to) the table, press F3 (Exit) or F12 (Cancel) to 
return to the Work with Query Manager Tables display. 


Note: If you create a table with a name that exceeds 10 characters in length or contains special 
characters, you will see two table names in the Work With Query Manager Tables display once you 
return to that display after leaving it. One name is the name you gave the table. The other name is 
a name generated by the system. Both names refer to the same table. 


While you are creating a table you can change a column definition or delete an entire column. However, 
once the table definition is saved, you cannot add, delete, or copy columns, or change the column 
definitions in any way. 


The only way to change the definition of an existing table is to copy it. Choose option 3 (Copy table) from 
the Work with Query Manager Tables display to create a new table by copying the definition of an existing 
one. When you copy the table, you can copy, delete, and add columns, and change column definitions in 
the same way as if you were creating a new table. If you need to change a table definition, see 

for more information. 


The F21=Specify CREATE TABLE statement function key is provided for more sophisticated users who 
want to specify more detailed information about each column. When F21 is pressed, the interactive SQL 
Create Table display appears. Additional things the user can specify are: 


¢ Whether a column can contain NULL data 
¢ Whether the user can assign a different CCSID to a particular column 


All information that was previously entered on the Query Manager Create Table display is carried over to 
the Specify Create Table display. Once the user fills in the desired information on the Specify Create Table 
display and presses <ENTER> the Display SQL display appears. The user sees the exact CREATE 
TABLE SQL statement that was used to create the table. 


If you want to work through practice exercises in which you create and work with a Query Manager table, 
turn to x P 2 exe es fo 


Defining table columns in Query Manager 
The first step in defining a table is to decide what data the table should contain. 
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In a table, each column of a row is related in some way to all the other columns for that row. Columns of a 
table identify particular types of information. Each column needs to be of a particular data type, such as 
CHARACTER, INTEGER, DECIMAL, DATE, or TIME. When you define columns, you are enforcing a set 
of entry rules to help maintain data integrity. 


The rows contain the actual data of the table. The data in a row must conform to the column data types 
defined for the table. Each row is a sequence of column values that conform to the column data types 
defined for the table. 


Before you can define a table, you need to have some idea of the types of data you want in the table. In 
the STAFF table, shown below, the NAME column contains CHARACTER data, the ID column contains 


INTEGER data, and the SALARY column contains DECIMAL data. 
Table 11. The STAFF Table 


ID | NAME DEPT | JOB YEARS SALARY COMM 
10 | Sanders 20 | Mgr 7 18357.50 0 
20 | Pernal 20 | Sales 8 18171.25 612.45 
30 | Marenghi 38 | Mgr 5 17506.75 0 
40 | O’Brien 38 | Sales 6 18006.00 846.55 
50 | Hanes 15 | Mgr 10 20659.80 0 
60 | Quigley 38 | Sales 0 16808.30 650.25 
70 | Rothman 15 | Sales 7 16502.83 1152.00 
80 | James 20 | Clerk 0 13504.60 128.20 
90 | Koonitz 42 | Sales 6 18001.75 1386.70 
100 | Plotz 42 | Mgr 7 18352.80 0 


When you define a column’s data type, length, and number of decimal places, you indicate the kind of 
data your table can contain for that column, and what operations can be performed using the data. For 
example, since DECIMAL data can have arithmetic operations performed on it, you could calculate 
SALARY plus COMM in a report form. 


You should also determine the order in which the columns should appear. As a rule, you should consider 
an order appropriate for the person entering the data. For example, if the information is being entered from 
employee time sheets, define the table with the columns in the same order as the information appears on 
the time sheet. 


After you have determined the particular types of data the columns in your table should contain and the 
order in which the columns should appear, you are ready to begin creating the table. 


Supported data types in Query Manager 


All of the supported data types that you can use when defining Query Manager tables are described in 
Do not specify a length for set length data types. 


Table 12. Query Manager Table Data Types 


Data Type Definition 


CHARACTER A CHARACTER or CHAR is a fixed length column that can hold any SBCS or DBCS characters. 
CHARACTER columns can range from 1 to 32,765 characters in length. 


A VARCHAR is a variable length character column that can hold any SBCS or DBCS characters. 
VARCHAR columns can range from 1 to 32,739 characters in length. 


VARCHAR 
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Table 12. Query Manager Table Data Types (continued) 


Data Type 


Definition 


DECIMAL 


A DECIMAL or DEC column holds numeric data that contains a decimal point. There can be a 
maximum of 31 digits in a DECIMAL column, with 0 to 31 decimal places. 


NUMERIC 


A NUMERIC or NUM column holds zoned decimal numeric data. There can be a maximum of 31 
digits in a NUMERIC column, with 0 to 31 decimal places. 


INTEGER 


SMALLINT 


An INTEGER or INT column holds a large positive or negative whole number: from -2,147,483,648 
to 2,147,483,647. (Long binary.) INTEGER columns are set length. 


A SMALLINT or SMALL column holds a small positive or negative whole number: from -32,768 to 
32,767. (Short binary.) SMALLINT columns are set length. 


REAL 


A REAL column holds single precision short floating-point numeric data (scientific notation). REAL 
columns have a set length of 23 digits. 


DOUBLE 


A DOUBLE column holds double precision long floating-point numeric data (scientific notation). 
DOUBLE columns have a set length of 53 digits. 


FLOAT 


A FLOAT column holds floating-point numeric data (scientific notation). The length you specify 
determines whether the FLOAT column is a REAL or a DOUBLE data type. A length of 1 to 23 digits 
indicates a REAL data type; a length of 24 to 53 digits indicates a DOUBLE data type. 


DATE 


A DATE column holds a three-part value that denotes year, month, and day in one of the formats 
shown below. DATE columns are set length. 


ISO yyyy-mm-dd 1992-10-12 
USA mm/dd/yyyy 10/12/1992 
EUR dd.mm. yyyy 12.10.1992 
JIS yyyy-mm-dd 1992-10-12 


TIME 


TIMESTAMP 


A TIME column holds a three-part value that denotes hour, minute, and second in one of the formats 
shown below. TIME columns are set length. 


ISO 13.30.05 
USA 5:30 PM 
EUR 13.30.05 
JIS 13:30:05 


hh.mm.ss 
hh:mm AM/PM 
hh.mm.ss 
hh:mm:ss 


A TIMESTAMP column holds the system date and time as a seven-part value that denotes year, 
month, day, hour, minute, second, and microsecond entered in the format shown below. 
TIMESTAMP columns are set length. 


yyyy-mm-dd-hh.mm.ss.nnnnnn 1992-10-12-13.30.05.123456 


GRAPHIC 


A GRAPHIC is a fixed length column that holds double-byte character set (DBCS) data. GRAPHIC 
values cannot be operated on arithmetically. GRAPHIC columns can range from 1 to 16,383 
characters in length. (Length specifications are given in characters, not bytes.) 


VARGRAPHIC 


A VARGRAPHIC is a variable length graphic column that holds double-byte character set (DBCS) 
data. VARGRAPHIC values cannot be operated on arithmetically. VARGRAPHIC columns can range 
from 1 to 16,370 characters in length. (Length specifications are given in characters, not bytes.) 


BIGINT 


A big integer is a binary number composed of 8 bytes (64 bits) with a precision of 19 digits. The 
range of big integers is -9223372036854775808 to +9223372036854775807. 


BLOB 


A Binary Large OBject (BLOB) is a varying-length string with a maximum length of 2 147 483 647. A 
BLOB is designed to store non-traditional data such as pictures, voice, and mixed media. BLOBs 
can also store structured data for use by distinct types and user-defined functions. A BLOB is 
considered to be a binary string. Although BLOB strings and FOR BIT DATA character strings might 
be used for similar purposes, the two data types are not compatible. The BLOB function can be 
used to change a FOR BIT DATA character string into a binary string. The CCSID of a BLOB is 
65535. 


CLOB 


A Character Large OBject (CLOB) is a varying-length character string with a maximum length of 2 
147 483 647. A CLOB is designed to store large SBCS data or mixed data, such as lengthy 
documents. For example, you can store information such as an employee resume, the script of a 
play, or the text of novel in a CLOB. The CCSID of a CLOB cannot be 65535. 
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Table 12. Query Manager Table Data Types (continued) 


Data Type Definition 


DATALINK A DATALINK value is an encapsulated value with a set of built-in scalar functions. The maximum 
length must be in the range of 1 through 32717. 


DBCLOB A Double-Byte Character Large OBject (DBCLOB) is a varying-length graphic string with a maximum 
length of 1 073 741 823 double-byte characters. A DBCLOB is designed to store large DBCS data, 
such as lengthy documents in UCS-2. The CCSID of a DBCLOB cannot be 65535. 


ROWID A row ID is a value that uniquely identifies a row in a table. A column or a host variable can have a 
row ID data type. A ROWID column enables queries to be written that navigate directly to a row in 
the table. Each value in a ROWID column must be unique. Database manager maintains the values 
permanently, even across table reorganizations. When a row is inserted into the table, database 
manager generates a value for the ROWID column unless one is supplied. If a value is supplied, it 
must be a valid row ID value that was previously generated by either DB2 UDB for OS/390 or DB2 
UDB for iSeries. The internal representation of a row ID value is transparent to the user. The value 
is never subject to CCSID conversion because it is considered to contain BIT data. The length 
attribute of a ROWID column is 40. 


The difference between DECIMAL and NUMERIC in Query Manager 


You enter number values for the DECIMAL and NUMERIC data types in exactly the same format. The only 
difference between these two data types is the way in which the values are stored by the iSeries system. 
If you are going to perform arithmetic operations with a number, it is more efficient to define it as 
DECIMAL; if a number is going to be used mostly for display purposes, it is more efficient to define it as 
NUMERIC. 


The difference between CHARACTER and VARCHAR in Query Manager 


You enter values for the CHARACTER and VARCHAR data types in exactly the same format. The only 
difference between these two data types is the way in which the values are stored by the iSeries system. 
If you define a CHARACTER column with a length of 20, Query Manager stores the column value with a 
fixed length of 20 characters. If you define a VARCHAR column with a maximum length of 20, Query 
Manager checks to see what the actual length of the column value is. Any trailing blanks are stripped from 
the value before it is stored, so that a value that is only 5 characters in length, takes only 5 characters of 
storage space instead of 20. 


Note that a VARCHAR value containing no characters (an implied length of zero), does not have a NULL 
value. 


Default values for data types in Query Manager 


When you add data rows to a Query Manager table, if you leave any column values unfilled, Query 
Manager inserts default values for the empty columns. CHARACTER, VARCHAR, GRAPHIC, and 
VARGRAPHIC columns have blanks inserted as their default values. DATE, TIME, and TIMESTAMP 
columns have the current date and/or time inserted as their default values. The remaining data types, 
which all hold number values, have zeros inserted as their default values. 


Default values are also used when you copy a Query Manager table. If you choose to copy data and you 
change the table definition by adding new columns, Query Manager inserts the default values into the 
newly created columns of the copied data rows. 


NULL values in Query Manager 


A null value is a value that is not known. This differs from a blank value which actually contains a blank 
character or space. The tables that you create through the Work with Query Manager Tables display do 
not contain null values as default, but you can enter null values by typing the word NULL (in uppercase) 
as a column value. Tables that were created outside Query Manager that you access through the Work 
with Query Manager Tables display can also contain null values. 
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Query Manager indicates a null value by the word NULL. If you want to change the value of a column to a 
null value, type the word NULL over the existing column value. This ensures that the column contains 
nothing, rather than a blank character or space. You can also search for rows that contain null values by 
typing NULL as the value for which you want to search. When a null value is printed or displayed on a 
report, it is shown as a hyphen (-). 


Adding data to a table in Query Manager 


You can add data rows to a table in two ways: either by selecting option 9 (Add data) from the Work with 
Query Manager Tables display, or by pressing F19 (Add data) immediately after you create or copy a 
Query Manager table. 


1. Type 3 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Tables display. If you do not have a “Default collection for QM tables” 
specified in your Query Manager profile, you are prompted to specify the name of the collection you 
want to use (See page L156). 


2. Type 9 in the Opt prompt next to the names of the tables to which you want to add data rows; then 
press the Enter key to show the Add Data to Query Manager Table display for the first table you 
specified. Add Data displays for the remaining tables are shown in the same order as the table names 
appear in the “Work with” display list. An example of the Add Data display is shown in 


> 
Add Data to Query Manager Table 
Table ass ee 2 CSTARE 
Description ... . : The STAFF Table 
Type information up to (]), press Enter. 
Column Value 
ID [ 0 uh 
NAME [ I 
DEPT [ 0 I 
JOB [ J 
YEARS [ 20 I 
SALARY [ 0.00 if 
COMM [ 0.00 if 
Bottom 

F3=Exit F5=Refresh F1l=Display type/length F12=Cancel 
F20=Display entire name F22=QM statement 


Figure 88. Add Data to Query Manager Table Display 


3. Type the values that make up the row. The square brackets [ ] on the entry lines show you the 
maximum length defined for each column. If the prompt for a column is more than one line in length, 
Query Manager automatically line wraps for you, and moves the cursor from the end of entry line 1 to 
the beginning of entry line 2, allowing you to continue data entry. 


If you want to enter_a null value for a column, type the word NULL in uppercase. Null values are 
described on page 


When you finish entering the value for one column, press the Field Exit key or Tab key to move the 
cursor to the prompt for the next column. Do not press the Enter key until you have finished entering 
all values for the row. Pressing the Enter key saves whatever is currently shown on the display. If you 
save an incomplete row, you can use option 10 (Change data) to correct it. See page L164 for 
instructions. 
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type/length) to view the table definition. See 
for instructions. 


4. Press the Enter key when you finish typing the row data. This saves the row, and shows an empty 
data entry display ready for you to enter the next row. 


If you made any mistakes typing the row data, (for example, if you enter letters in a number prompt), 
Query Managerhighlights the errors, and shows messages at the bottom of the display telling you how 
to correct each entry. You cannot save a row that contains information that is not valid. Correct your 
errors; then press the Enter key again. 


5. Press F3 (Exit) or F12 (Cancel) when you want to leave the Add Data to Query Manager Table 
display and return to the Work with Query Manager Tables display. 


Adding DBCS data to a table in Query Manager 


The double-byte character set (DBCS) is a set of characters in which each character is represented by two 
bytes. Languages such as Japanese, Chinese, and Korean, which contain more symbols than can be 
represented by 256 code points, require double-byte character sets. Because each character requires two 
bytes, the typing, displaying, and printing of DBCS characters requires hardware and programs that 
support DBCS. 


You can enter DBCS characters for Query Manager table values for a column defined with a GRAPHIC, 
VARGRAPHIC, CHARACTER, or VARCHAR data type. 


Each DBCS value needs to be enclosed between shift-out (SO) and shift-in (SI) characters. When you are 
using a DBCS-capable keyboard, Query Manager automatically places the SO/SI characters in GRAPHIC 

and VARGRAPHIC input fields, which forces you to enter only DBCS characters. If you accidentally delete 
one or both of the SO/SI characters, Query Manager displays an error message telling you that the value 

is not a valid DBCS string. Press F5 (Refresh) to restore the previous values for the display; then re-enter 
the DBCS value. 


If you enter a value that is longer than the maximum length defined for the column, Query Manager 
truncates it, and discards the excess characters and blank spaces to the right of the value. If the prompt 
for a DBCS value is more than one line in length, Query Manager will concatenate the DBCS strings that 
you enter as long as the first character on each line is a shift-out character. 


DBCS values need to be entered in insert mode. When you are in insert mode, every time you type a 
character, the square bracket that indicates the maximum length for the column moves one character 
space to the right. You might need to delete the blank spaces between the shift-in character and the 
square bracket before you can enter your column value. 


If you are using a keyboard that is not DBCS-capable, you can enter non-DBCS characters for a 
GRAPHIC or VARGRAPHIC data type. You must enter an even number of characters between the 
shift-out and shift-in characters. The non-DBCS characters are valid on a non-DBCS-capable display, but 
they may not be valid DBCS characters. 


Note: When you create a table using a display station that is DBCS-capable, all columns defined with 
CHARACTER and VARCHAR data types are “DBCS-open”, which means that they accept both 
SBCS and DBCS characters. 


Query Manager automatically places the SO/SI characters in input fields on the Add Data to Query 
Manager Table and Change Data in Query Manager Table displays for GRAPHIC and VARGRAPHIC data 
types. If you want to enter a DBCS string on the Find Data in Query Manager Table display, or on any of 
the Select Report Format or Define Prompted Query displays, you need to enter the SO/SI characters 
yourself. 
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Viewing display type/length information in Query Manager 


If you want to view the definition of a table to see what the data types, lengths, and number of decimal 
places are for the different columns, press F11 (Display type/length). The table definition is displayed in a 
format similar to the Create Query Manager Table display. 


This table definition is shown in display-only format. You cannot change any of the information shown in 
the display. If you want to change the table definition, you need to copy the table (see page : 


When you finish viewing the table definition, press F11 (Display value) to return to the data entry display. 
An example of the F11 (Display type/length) display is shown in L 


a 


Add Data to Query Manager Table 
Table sett sees | TARE 
Description .... : The STAFF Table 
Type information up to (]), press Enter. 

Decimal 
Column Type Length Places 
ID INTEGER 
NAME CHARACTER 9 
DEPT INTEGER 
JOB CHARACTER 5 
YEARS INTEGER 
SALARY DECIMAL 9 2 
COMM DECIMAL di 2 
Bottom 

F3=Exit F5=Refresh F11=Display values F12=Cancel 
F20=Display entire name F22=QM statement 


Figure 89. Display Type/Length Information Display 


Changing data in a table in Query Manager 


You can use the Change Data option to change the contents of individual rows in a table and to delete 
rows no longer required. 


1. Type 3 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Tables display. If you do not have a “Default collection for QM tables” 
specified in your Query Manager profile, you are prompted to specify the name of the collection you 
want to use (see page , 


2. Type 10 in the Opt prompt next to the names of the tables that contain the row data you want to 
change or delete; then press the Enter key to go to the Change Data option. The Find Data in Query 
Manager Table display is shown for the first table you specified. Find Data displays for the remaining 
tables are shown in the same order as the table names appear in the “Work with” display list. 


An example of the Find Data display is shown in Figure 90 on page 164. 


3. Specify search conditions to select the rows you want to change; then press the Enter key. If you want 
to change all rows, press the Enter key without specifying any search conditions. Specifying search 
conditions is described on page hed. 

Query Manager performs a search using the conditions you specified; then shows the first row it found 


in a Change Data in Query Manager Table display. An example of the Change Data display is shown 
in Figure 7 on page 164. 
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4. Type new row values over the existing values that you want to change; then press the Enter key to 
save your changes. Press F3 (Exit) or F12 (Cancel) to leave the display without saving the changes 
you made. See page for instructions. 


5. Press F15 (Next data row) to display the next row in the currently selected set of rows, or 
F14 (Previous data row) to display the previous row. Press F16 (Find data) if you want to return to the 
Find Data display, and alter the existing search conditions to find a new set of rows. See page for 
information on the Change Data display function keys. 

6. Press F3 (Exit) or F12 (Cancel) when you want to leave the Change Data display and return to the 
Work with Query Manager Tables display. When you exit from the Change option, Query Manager 
discards all of the search conditions you specified. 


Searching for rows in Query Manager 


Before you can change data, you need to tell Query Manager which rows you want to change. You do this 
by defining search conditions for the different columns. For example: 


¢ If you want to select the manager for department 10, tell Query Manager to search for all rows where 
DEPT equals 10 and JOB equals Mgr. 


¢ If you want to select all sales staff who have been with the company for more than 6 years, tell Query 
Manager to search for all rows where JOB equals Sales and YEARS is greater than 6. 


You use the search option not only to find data rows to change, but also to find data rows to use with the 
following Work with Query Manager Tables options: 


5=Display table 
6=Print table 
11=Display data 
Specifying search conditions in Query Manager 


The first display you see after choosing to Change Data, is the Find Data in Query Manager Table display. 
You use this display to define your search conditions. An example of the Find Data display is shown in 


(7 ; : > 
Find Data in Query Manager Table 
Tabliew ssc. «sea | SOTARE 
Description ... . : The STAFF Table 


Type search conditions, press Enter. 
No conditions entered will find all data. 


Column Test Value 


) 
Bottom 
F3=Exit F4=Prompt F6=Insert line F10=Copy line  F12=Cancel 
dub a line F20=Display entire name F22=QM Statement 


Figure 90. Find Data in Query Manager Table Display 
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You can specify search conditions for all of the columns in the currently selected table. To create a search 
condition, you need to enter the following information: 


¢ AND, OR, (, ). All searches need to start with an opening parenthesis ‘(’ and end with a closing 
parenthesis ‘)’. You can also use parentheses to group search conditions. Use AND or OR to join 
search conditions and groups of conditions. You can press F4 (Prompt) while the cursor is positioned 
on the AND, OR, (, ) prompt, to display a description of these values. 


Use AND if two or more conditions or groups of conditions need to be true. For example, to select all 
employees whose salaries range between $16,000 and $18,000, you would search for SALARY greater 
than 16000 “AND” SALARY less than 18000. 


Use OR if only one of the conditions needs to be true. For example, to select all clerks and all sales 
staff, you would search for JOB equals Sales “OR” JOB equals Clerk. 


¢ Column. Type the name of the column on which you want the search condition performed. If you are 
unsure of the column names for this table, press F4 (Prompt) while the cursor is positioned on this 
prompt, to display a list. Type 1 in the Opt prompt next to the name of the column you want to choose; 
then press the Enter key. 


* Test. You can press F4 (Prompt) while the cursor is positioned on this prompt, to display a list of all 
available test conditions, from which you can make a selection. The conditions that are supported for 
Query Manager tables are shown in Table 14 


Table 13. Search Conditions 


Cond Description 

EQ Equal to (Exact match) 
NE Not Equal to 

GT Greater Than 

GE Greater Than or Equal to 
LT Less Than 

LE Less Than or Equal to 


¢ Value. Type the value that you want Query Manager to compare against the row data from the specified 
“Column”. Make sure the value you enter is compatible with the column’s data type and length. If the 
value you want to enter is longer than the prompt shown on the display, press F4 (Prompt) while the 
cursor is positioned on this prompt, to display an extended entry window through which you can type 
the value. 


If you are performing the search on number data, you can enter a number, an expression, or the name 
of another column that contains number data. 


If you are performing the search on a character value, you can enter a character string, or the name of 
another column that contains character data. Enclose column names in double quotation marks, but do 
not enclose character strings in quotation marks. When you enter a character string, Query Manager 
searches for the value exactly as you type it, recognizing uppercase and lowercase letters. 


If you are performing the search on a graphic value, you can enter a graphic string, a character string, 
or the name of another column that contains graphic data. Enclose column names in double quotation 
marks, and character strings in shift-out (SO) and shift-in (SI) characters. You can enter either SBCS or 
DBCS strings as graphic values. When you enter SBCS strings, the characters should be uppercase 
letters only, and remember that each character needs to be two bytes in length. When you enter a 
graphic string, it needs to begin with the letter G (to identify the string as graphic) and be enclosed in 
single quotation marks and DBCS SO/SI characters. The following example uses < and > to indicate the 
SO/SI characters: G'<A B C D E >'. For more information on graphic strings, turn to 


type the word NULL (in uppercase) as the search value. Null values are described on page heal 
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The Find Data in Query Manager Table display provides nine lines on which you can define your search 
conditions. You can use F6 (Insert line), F10 (Copy line), and F14 (Delete line) to increase or decrease 
the number of lines, and otherwise edit the search conditions as you create them. These function keys are 
described on page bd. 


When you finish defining the search conditions, press the Enter key to begin the search. 


Note: If you press the Enter key without having defined any search conditions, Query Manager selects all 
rows in the table. 


Eigure 91] shows the search conditions you would enter to find all employees who work in either DEPT 20 
or DEPT 42. 


r > 
Find Data in Query Manager Table 
Pablier esse vet are SOTARE: 
Description ... .: The STAFF Table 


Type search conditions, press Enter. 
No conditions entered will find all data. 


AND,OR, 
(,) Column Test Value 
(2s DEPT. EQ 20 
OR_ DEPT. EQ 42 
) 
Bottom 
F3=Exit F4=Prompt F6=Insert line F10=Copy line  F12=Cancel 


Co ererlele line F20=Display entire name  F22=QM Statement 


Figure 91. Example Search Condition 


If you made any errors defining the search conditions, Query Manager highlights the errors, and shows 
error messages at the bottom of the display telling you how to correct each entry. Correct any errors; then 
press the Enter key again to perform the search. 


If no rows are found in Query Manager 
If the search is unsuccessful and no data rows are found, Query Managershows an error message at the 
bottom of the Find Data display, and prompts you to enter new search conditions. 


Type the new conditions, or press F3 (Exit) or F12 (Cancel) to leave the Find Data display and return to 
the Work with Query Manager Tables display. 


Note: The error message is displayed only if you are searching for rows through the Change Data, 
Display Data, or Print Table options. If a search finds no rows when you are using the Display Table 
option, Query Manager shows a blank display report instead of an error message. 


Changing the data in Query Manager 

When Query Manager completes the search, it shows a Change Data in Query Manager Table display 
containing the first data row found that matched the search conditions. The Change Data display is similar 
in appearance to the Add Data display, and the same data entry rules apply. See page 6d for data entry 
instructions. 
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An example of the Change Data display is shown in Figure 92. 


BS 
Change Data in Query Manager Table 
Td Des Gere ews csesso OS TARE: Current: row 3... 3 1 
Description .... : The STAFF Table 
Type information up to (]), press Enter. 
Column Value 
ID [ 10 ] 
NAME [ Sanders] 
DEPT [ 20 ] 
JOB [ Mgr_] 
YEARS Lez ] 
SALARY [ 18357.50__] 
COMM [ 0.00] 
Bottom 

F3=Exit F5=Refresh Fll=Display type/length F12=Cancel 
Fl4=Previous data row F15=Next data row Fl6=Find data F24=More keys ) 

~ 
F20=Display entire name F22= QM statement F23=Delete data row 
F24=More keys g 


Figure 92. Change Data in Query Manager Table Display 


Move the cursor to the value you want to change and type a new value over the existing one. When you 
complete changing all values in the currently displayed row, press the Enter key to save your changes. 


If you made any mistakes entering the row data, Query Manager highlights the errors, and shows 
messages at the bottom of the display telling you how to correct each entry. You cannot save a row that 
contains information that is not valid. Correct your errors; then press the Enter key again. 


If one of the displayed prompts contains a value of NULL, that column contains no information. If you want 
to change a column to have a null value, type the word NULL (in uppercase) as the prompt value. For 
more information on null values, see page } 


Using the change data display function keys in Query Manager 

You can use F14 (Previous data row) and F15 (Next data row) to display the previous and following rows 
that were selected as a result of the search. F23 (Delete data row) deletes the currently displayed row, 
and F16 (Find data) displays the Find Data in Query Manager Table display, through which you can alter 
the existing search conditions. These function keys are described below. The other function keys that are 
used throughout Query Managerare described on page bal. 


F11 Display type/length. Changes the display so you can view the table definition, and see what the 
data types, lengths, and number of decimal places are for the different columns. When you 
complete viewing the definition, press F11 (Display values) to return to the Change Data display. 


F14 Previous data row. Displays the data row immediately prior to the currently displayed row (from 
within the set of selected rows). 


F15 Next data row. Displays the data row immediately following the currently displayed row (from 
within the set of selected rows). 
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F16 Find data. Displays the Find Data in Query Manager Table display, through which you can alter 


the existing search conditions. The Find Data display holds all of the settings for the current 
search. 


If you want to discard the existing conditions and create a new search, you can either: 
¢ Blank out the existing conditions on the Find Data display. 


¢ Press F3 (Exit) or F12 (Cancel) to return to the Work with Query Manager Tables display. 
When you exit from the Change Data option, Query Manager discards all of the search 
conditions you specified. If you now choose the Change Data option, you can define new 
search conditions. 


F20 Display entire name. Brings up a window that displays the entire name of a column if only part of 


F23 


Not 


the name appears on the display. 


Delete data row. Deletes the currently displayed data row. You need to respond to a confirm 
message before the delete occurs. Press F23 a second time to perform the delete. 


e: If you make changes to a data row, the only way you can save those changes is by pressing the 
Enter key. If you press F14 (Previous data row) or F15 (Next data row) before pressing the Enter 
key, any changes you made to the row are discarded. 


Displaying data in a table in Query Manager 


You 


can view selected table rows one at a time in a format similar to the Add Data display. The information 


is shown in display-only format. You cannot change any values through this option. 


1; 


Type 3 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Tables display. If you do not have a “Default collection for QM tables” 
specified in your Query Manager profile, you are prompted to specify the name of the collection you 
want to use (see page 


Type 11 in the Opt prompt next to the names of the tables that contain the row data you want to 
display; then press the Enter key to go to the Display Data option. The Find Data in Query Manager 
Table display is shown for the first table you specified. Find Data displays for the remaining tables are 
shown in the same order as the table names appear in the “Work with” display list. 


pisell search conditions to select the rows you want to display; then press the Enter key. See 
66 for instructions. If you want to display all rows, 
pipes the Enter key without specifying any search conditions. 


Query Managerperforms a search using the conditions you specified; then shows the first data row it 
found in a Display Data in Query Manager Table display. If no rows are found as a result of the search, 
you see a message telling you that no rows were found, and asking if you want to redefine the search 
conditions. 


An example of the Display Data display is shown in [Eigure 93 on page 171]. 
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Display Data in Query Manager Table 


Table}, asekie ee nes sonsns STAFF Current: Ow! a e402 1 
Description ... .: The STAFF Table 

Column Value 

ID 10 

NAME Sanders 

DEPT 20 

JOB Mgr 

YEARS 7 

SALARY 18357 .50 

COMM 0.00 


Bottom 
Press Enter to continue. 


F3=Exit F12=Cancel Fl4=Previous data row’ F15=Next data row 
Fl6=Find data F20=Display entire name F22=QM statement 


Figure 93. Display Data in Query Manager Table Display 


4. When you finish viewing a row, you can press F14 (Previous data row) or F15 (Next data row) to view 
the rows immediately before or immediately after the currently displayed row (from within the set of 
selected rows). Pressing F16 (Find data) returns you to the Find Data display, through which you can 
alter the existing search conditions. 


If you want to define new search conditions rather than altering the existing conditions, you can either: 
¢ Blank out the existing conditions on the Find Data display. 


¢ Press F3 (Exit) or F12 (Cancel) to return to the Work with Query Manager Tables display. When 
you exit from the Display Data option, Query Manager discards all of the search conditions you 
specified. If you now choose the Display Data option, you can define new search conditions. 


5. Press F3 (Exit) or F12 (Cancel) when you want to leave the Display Data display and return to the 
Work with Query Manager Tables display. 


Copying a table in Query Manager 


When you copy a Query Manager table, you can create a new table, or replace an existing one. The 
copied table can be an exact copy of the original table’s definition, or you can make modifications to the 
definition before the copy occurs. You can also choose to copy the table definition only, or to copy the 
definition and the table data. 


Copying is the only way that you can change the definition of a Query Manager table. There is no Change 
Table Definition option available through the Work with Query Manager Tables display. 


Note: If you have a BASIC access level, you need to have *CHANGE authority for the current collection 
to copy a table through Query Manager. 


1. Type 3 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Tables display. If you do not have a “Default collection for QM tables” 
specified in your Query Manager profile, you are prompted to specify the name of the collection you 
want to use (See page 


2. Type 3 in the Opt prompt next to the names of the tables you want to copy; then press the Enter key 
to go to the Copy Query Manager Table display. This display lists the names of all of the tables you 
specified. An example of the Copy Table display is shown in 
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( > 
Copy Query Manager Table 


Brom, Iaibrany wc. ese oe Se ce MYCOLE 


Type information, press Enter. 


TooihibRary csc: i) canes ete aes se MYCOLL Name 
Replace tables. 2. i Sn N Y=Yes, N=No 
Copy data: so ae a ee eS i Y=Yes, N=No 


To rename copied table, change To Table name. 


From Table To Table 
STAFF STAFF2 


Bottom 
F3=Exit F5=Refresh F12=Cancel F20=Display entire name 
Gao Statement 


Figure 94. Copy Query Manager Table Display 


3. Before you can copy a table, you need to specify the following information. If you choose to copy more 
than one table, all tables are copied using the same settings. 

* To collection. If you have an ALL access level, you can type the name of the collection to which 
you want the table copied. You need to have *CHANGE authority for the collection to which you are 
copying. 

* Replace table. Type Y if you want to replace an existing table, or N if you want to create a new 
table. The default is N. 

* Copy data. Type Y if you want to copy the data rows the table contains, or N if you want to copy 
the table definition only. The default is N. 

4. Type the name of the table you want to create or replace in response to the “To Table” prompt. If you 
answered N to the “Replace table” prompt, the name you type cannot already exist in the specified 
collection. 

Table naming conventions are described on page bal 


5. Press the Enter key to show the Create Query Manager Table display showing the definition of the first 
table you specified. Create Table displays for the remaining tables are shown in the same order as the 


table names at in the “Work with” display list. An example of the Create Table display is shown in 
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Create Query Manager Table 


Type choices, press Enter. 


iid DiC eras sce pececer eesti STAFF2 Name 
Description) i: acs, ae The STAFF Table 

Decimal 
Column Type Length Places 
ID INTEGER__ noe, 
NAME. CHARACTER _ 9 —_ 
DEPT. INTEGER ae 
JOB CHARACTER_ i} = 
YEARS. INTEGER _ = 
SALARY. DECIMAL ___ 9 Zoe 
COMM DECIMAL i apn 

Bottom 

F3=Exit F4=Prompt F5=Refresh Fo=Insert line F10=Copy line 


F12=Cancel Fl4=Delete line F19=Add data F24=More keys 


Figure 95. Create Copied Table Display 


6. You can change the table definition while the message “Press Enter to create the copied table and 
copy the data.” is displayed. When you copy an existing table, you effectively create a new one. You 
can now change the definition of the table the same way you would if you were using option 1 (Create 
table) from the Work with Query Manager Tables display. See page for instructions on how to use 
the Create Table display and its function keys. 


If you copied table data in addition to copying the definition, you should be careful not to make major 
changes to the table definition. Query Manager does its best to fit the data into the newly defined 
columns using the following guidelines: 
¢ Data is copied when a column in the new table has the same name as a column in the old table, as 
long as the columns have compatible data types. You can change the length of the column and its 
position within the definition, but you cannot change its name or give it an incompatible data type. 
— CHARACTER and VARCHAR are compatible. If the columns hold only DBCS characters, or an 
even number of SBCS characters, they can also be copied to GRAPHIC and VARGRAPHIC 
columns. 


— GRAPHIC and VARGRAPHIC are compatible. These columns can also be copied to 
CHARACTER and VARCHAR columns. 


— NUMERIC and DECIMAL are compatible. 
— INTEGER and SMALLINT are compatible. 
— REAL, DOUBLE, and FLOAT are compatible. 


* When you decrease the length of a character column, any column values that are longer than the 
new length are truncated on the right. 

¢ When you change the length of a number column, if a significant number of digits needs to be 
truncated because a shorter length is specified, the column is set to the default value of zero. If the 
length or number of decimal places is increased, zeros are added before or after the number. 

* The new columns you create are filled with default values depending on their data types (for 
example, blanks for characters and zeros for numbers). 

* Query Manager discards the data from the columns that existed in the old table but do not exist in 
the new one. 

7. Press the Enter key when you are ready to complete the copy and save the table definition. You 
cannot save a table that contains column definitions that are not valid. If Query Manager finds any 
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errors when you try to save the table, it highlights the values that are not valid one at a time, and 
shows messages at the bottom of the display telling you how to correct each entry. 


If you want to leave the Create Table display without saving your newly copied table definition, press 
F3 (Exit) or F12 (Cancel) instead of the Enter key. 


When the table has been successfully saved, you see a message at the bottom of the display telling 
you that the table has been copied. You can now press F19 (Add data) if you want to add row data to 
the newly copied table. See i for data entry 
instructions. 


Press F3 (Exit) of F12 (Cancel) when you want to leave the Create Table display and return to the 
Work with Query Manager Tables display. 


Deleting a table in Query Manager 


When you choose to delete the definition and data of a Query Manager table, Query Managershows a 
confirm display. No tables are deleted until you respond to this display. 


1. 


Type 3 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Tables display. If you do not have a “Default collection for QM tables” 
specified in your Query Manager profile, you are prompted to specify the name of the collection you 
want to use (see page 

Type 4 in the Opt prompt next to the names of the tables that you want to delete; then press the Enter 
key to go to the Confirm Delete of Table display. This display lists the names of all of the tables you 
selected to delete. When you delete a table that is represented by two names, both table names are 
deleted. There are two table names anytime you name a table: 


* Aname longer than 10 characters 


¢ Aname that contains characters not valid in a system name 


ie = 
Confirm Delete of Table 
Library =: aa IMYEOLL 
Press Enter to confirm your choices for 4=Delete. 
Press Fl2 to return to change your choices. 
Opt Table Description 
4 APPLICANT Table of job applicants 
4 CARS Sample CARS Table 
4 STAFF The STAFF Table 
F1l=Display table only  F12=Cancel F20=Display entire name 
Ne 4 


Figure 96. Confirm Delete of Table Display 


When you choose to delete more than one table, you may want to press F11 (Display table only) to 
hide the table descriptions and show multiple columns of table names on the display. 
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3. Press the Enter key to confirm the delete and return to the Work with Query Manager Tables display. 
Note that when you press the Enter key, you delete all of the tables shown on the display. If you want 
to leave the Confirm Delete display without deleting any tables, press F12 (Cancel) instead of the 
Enter key. 


Displaying a table in Query Manager 


You can view selected rows of data from a table in a Display Report. Use this option to view table reports 
prior to printing. 


Note: If the “Run query mode” setting in your Query Manager profile is batch, you cannot use your display 
for output, so this option is not available through the Work with Query Manager Tables display. See 
8! for more information. 


1. Type 3 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Tables display. If you do not have a “Default collection for QM tables” 
specified in your Query Manager profile, you are prompted to specify the name of the collection you 
want to use (See page 156). 


2. Type 5 in the Opt prompt next to the names of the tables that contain the rows you want to display; 
then press the Enter key to go to the Display Table option. The Find Data in Query Manager Table 
display is shown for the first table you specified. Find Data displays for the remaining tables are shown 
in the same order as the table names appear in the “Work with” display list. 


3. Specify search conditions to select the rows you want to display; then press the Enter key. If you want 
to display all rows, press the Enter key without specifying any search conditions. See Peaactngtl 
64 for instructions. 


Query Managerperforms a search using the conditions you specified; then displays all of the rows it 
selected in a Display Report. When you see More... in the lower right-hand corner of the display, it 
means that the report is more than one display in length. Use the display station’s roll keys to view the 
entire report. 


An example of the Display Report display is shown in [Figure 97 on page 176. 


If no rows are displayed, it means that the search was unsuccessful and found no rows. Press 

F3 (Exit) or F12 (Cancel) to leave the Display Report display and return to the Work with Query 
Manager Tables display. You can then choose the Display Table option again if you want to define new 
search conditions. 


4. Press F3 (Exit) or F12 (Cancel) when you want to leave the Display Report display and return to the 
Work with Query Manager Tables display. When you exit from the Display Table option, Query 
Manager discards all of the search conditions you specified. 


Note: If you press F12 (Cancel) to leave the Display Report display, ignore any messages that warn 
you that you might lose active data. If you press F3 (Exit) to leave the display, answer NO to 
any prompt asking if you want to continue running a query. The Query Manager tables options 
have no effect on active data. The only way that you can create active data in Query Manager 
is to run an SQL SELECT statement query or prompted query in interactive mode. 
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; ~ 
Display Report 

Width: se i 3 71 
Column «2 1 
Control Ate Sere 
LANG? caecste Hers crodisc net cowie enetsccceS e-ssrehe eure erections Deveasectievssee Oensstsncels 

ID NAME DEPT JOB ae SALARY COMM 
000001 10 Sanders 20 Mgr 7 18,357.50 00 
000002 20 ~~ Pernal 20 ~=Sales 8 185171.25 612.45 
000003 30 Marenghi 38 Mgr 5 17,506.75 00 
000004 40 O'Brien 38 =Sales 6 18,006.00 846.55 
000005 50 Hanes 15 Mgr 10 20,659.80 -00 
000006 60 Quigley 38 Sales 0 16,808.30 650.25 
000007 70 Rothman 15 Sales 7 16,502.83 1,152.00 
000008 80 James 20 ~=Clerk 0 13,504.60 128.20 
000009 90 Koonitz 42 Sales 6 18,001.75 1,386.70 
000010 100 = Plotz 42 Mgr 7 18,352.80 -00 
000011 110 Ngan 15 Clerk 5 12,508.20 206.60 
000012 120 Naughton 38 = Clerk 0 12,954.75 180.00 
000013 130 Yamaguchi 42 Clerk 6 10,505.90 75.60 
000014 140 ~=~Fraye 51 Mgr 6 21,150.00 00 

More 

F3=Exit F12=Cancel F19=Left F2Q=Right F21=Split y 


Figure 97. Display Report Display 


This display provides special function keys that you can use to view the entire report if it is more than one 
display in width. 


F21 Split. Splits the report into two displays vertically at the current cursor position. Move the cursor to 


the column at which you want to split the report; then press F21. Note that the cursor needs to be 
positioned on the column data, not on the column heading. 


F19 Left. Shows the columns that appear on the left-hand side of the report. If you defined a split, F19 


shows all columns to the left of the split. 


F20 Right. Shows the columns that appear on the right-hand side of the report. If you defined a split, 


F20 shows all columns to the right of the split. 


The Control prompt, shown above the columns of the report, also helps you view the entire report. 
Through this prompt, you can select and control paging, rolling, and window functions, and you can display 
a specific row from the report. Position the cursor on the Contro/ prompt and press F1 (Help) for full 
instructions. 


Printing a table in Query Manager 


When you print a table, you can choose to print the entire table, or you can search through the table and 
print only those rows that meet your search conditions. 


ile 


Type 3 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Tables display. If you do not have a “Default collection for QM tables” 
specified in your Query Manager profile, you are prompted to specify the name of the collection you 
want to use (see page 


Type 6 in the Opt prompt next to the names of the tables that contain the rows you want to print; then 
press the Enter key to go to the Print Table option. The Find Data in Query Manager Table display is 
shown for the first table you specified. Find Data displays for the remaining tables are shown in the 
same order as the table names appear in the “Work with” display list. 


Spaclt search conditions to select the rows you want to print; then press the Enter key. See 


64 for instructions. If you want to print all rows, press 
the Enter key without specifying any search conditions. 
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If you want to leave the Find Data display without printing a report, press F3 (Exit) or F12 (Cancel) 
instead of the Enter key. 


Query Manager performs a search using the conditions you specified; then prints all of the rows it 
selected in a report. If no rows are found as a result of the search, you see a message telling you that 
no rows were found, and asking if you want to redefine the search conditions. 


Query Manager displays a message at the bottom of the display telling you when the report has been 
successfully sent to print or batch. You then return to the Work with Query Manager Tables display. 
When you leave the Print Table option, Query Manager discards all of the search conditions you 
specified. 


The printed report shows columns in the same order as they appear in the table definition, with the table’s 
column names being used for the report headings. Column values are displayed using the width from the 
table definitions, and column names that are longer than the specified width are truncated. 


The table is printed using the default settings from your Query Manager profile. If you want to change any 


Renaming a table in Query Manager 


You can only change system names. You cannot change a table’s name if the name contains special 
characters or is longer than 10 characters. 


You can specify new names for more than one Query Manager table in a single operation. 


Note: You need to have *CHANGE authority for the current collection to rename a table through Query 
Manager. You can copy the table and assign a new name for the copied table. 


To rename a table: 


1. Type 3 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Tables display. If you do not have a “Default collection for QM tables” 
specified in your Query Manager profile, you are prompted to specify the name of the collection you 
want to use (see page 


2. Type 7 in the Opt prompt next to the names of the tables that you want to rename; then press the 


Enter key. The Rename Query Manager Table display is shown, listing the names of all of the tables 
you specified. An example of this display is shown in piace on ace vd 
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(— 
Rename Query Manager Table 
Collections 24 34 5% 2 IMYCOLE 
To rename table, type New Name, press Enter. 
Table New Name 
APPLICANT APPLICANT _ 
CARS CARS 
STAFF STAFF. 
Bottom 
F3=Exit F5=Refresh  F12=Cancel F22=QM statement 
XX Ey 


Figure 98. Rename Query Manager Table Display 


3. 


Type the new name for the table. Table naming conventions are described on page ed. You need to 
enter a table name that does not already exist in the current collection. You cannot use the Rename 
Table option to replace existing tables. 

If you choose to rename more than one table, you need to type new names for all of the tables before 
pressing the Enter key. 


Press the Enter key to save the renamed tables, and return to the Work with Query Manager Tables 
display. If you want to exit from the Rename Table display without specifying new table names, press 
F3 (Exit) or F12 (Cancel) instead of the Enter key. 


Displaying a table definition in Query Manager 


Query Manager displays the definition of a table in a format similar to the Create Table display, showing 
the name, data type, length, and number of decimal places for all of the table columns. This information is 
shown in display-only format. You cannot change any values through this option. 


1. 


Type 3 in the Selection prompt from the Query Manager main menu; then press the Enter key to show 
the Work with Query Manager Tables display. If you do not have a “Default collection for QM tables” 
specified in your Query Manager profile, you are prompted to specify the name of the collection you 
want to use (see page L156). 


Type 8 in the Opt prompt next to the names of the tables whose definitions you want to view; then 


press the Enter key. The Display Query Manager Table Definition display is shown for the first table 
you specified. Display Definition displays for the remaining tables are shown in the same order as the 


table names appear in the “Work with” display list. An example of the Display Table Definition display is 
shown in Figure 99 on page 179 
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Display Query Manager Table Definition 

Table: « 203 40% 2 osc: STARE 
Description ... . : The STAFF Table 

Decimal 
Column Type Length Places 
ID INTEGER 
NAME CHARACTER 9 
DEPT INTEGER 
JOB CHARACTER 5 
YEARS INTEGER 
SALARY DECIMAL 9 2 
COMM DECIMAL ih 2 

Bottom 

Press Enter to continue. 
F3=Exit F12=Cancel F20=Display entire name  F22=QM statement oy) 


Figure 99. Display Query Manager Table Definition Display 


3. Press F3 (Exit) or F12 (Cancel) when you finish viewing the table definition to return to the Work with 
Query Manager Tables display. 
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Chapter 9. Distributed relational database architecture (DRDA) 
in Query Manager 


The DRDA function of Query Manager allows the user to access multiple remote databases and perform 
commits and rollbacks on the databases in an organized way. Query Manager supports two types of 
connection management: 


* Remote Unit of Work (RUW) 
* Distributed Unit of Work (DUW) 


The Query Manager profile allows you to select which connection management method to use. 


Remote unit of work (RUW) in Query Manager DRDA 


Remote Unit of Work (RUW) is the default connection management method for Query Manager. With 
RUW, Query Manager continues to connect to its remote databases as it has in the past. Under RUW, 
only one connection is allowed to a relational database. Commits and rollbacks apply to the one allowed 
connection. 


Distributed unit of work (DUW) in Query Manager DRDA 


DUW connection management is much more powerful than RUW connection management. Under DUW, 
multiple relational database connections are allowed. Commits and rollbacks can be performed to several 
systems in an organized way. 


Connection management statements in Query Manager DRDA 


Query Manager supports the following connection statements: 
* CONNECT 

* COMMIT 

¢ DISCONNECT 

¢ RELEASE 

¢ SET CONNECTION 


These statements can be entered from the Query Manager Command Line. Only the COMMIT command 
is allowed in Query Manager Queries. These commands are discussed in detail in 


Connection management in Query Manager DRDA 


The CONNECT and RELEASE statements control whether a connection is in a held or released state. 
Released state refers to a condition when a disconnect is to occur for the connection at the next 
successful commit operation. A released state can be thought of as a pending disconnect. A rollback has 
no affect on connections. A held state means that a connection is not to be disconnected at the next 
commit operation. A connection is placed in the held state by the CONNECT statement. A connection is 
moved to the released state from the held state by the RELEASE statement. A connection in the released 
state cannot be returned to or placed in the held state. This means that a connection remains in a 
released state across unit-of-work boundaries when a rollback is issued or a commit results in a rollback. 


Regardless of whether a connection is in the held or released state, a connection can also be in the 
current or in the dormant state. A database in current state is the database where all SQL statements will 
be run. Dormant state refers to a condition when the connection is suspended. While the connection is in 
the dormant state, SQL statements use the connection only for commits and rollbacks. The SET 
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CONNECTION and CONNECT statements change the connection for the named relational database to 
the current state while existing connections are placed in or remain in the dormant state. Only one 
connection can be in the current state at any given time. When a dormant connection becomes current in 
the same unit of work, all locks, cursors, and prepared statements are restored to reflect their last use 
when the connection was current. 


The DISCONNECT statement destroys specified connections. Once a connection to a relational database 
is disconnected, an application must connect to that relational database again if SQL statements need to 
be directed to the relational database. For protected conversations, the RELEASE statement must be 
used. 


A protected conversation is a conversation that uses two-phase commit protocols to ensure that, even if a 
failure occurs, updates made on all databases that are part of the transaction are all committed or all 
rolled back to retain the integrity of the databases. 


Default activation group and Query Manager DRDA 


Query Manager runs in the Default Activation Group. Consequently, Query Manager allows you to manage 
the connections associated with the default activation group. 


Connecting to a relational database in Query Manager DRDA 


You can connect to a database using the CONNECT or SET CONNECTION statements. To establish a 
new connection use the CONNECT statement. To display a list of databases to which you can connect: 


1. Prompt from the Query Manager Command Line 
2. Select the CONNECT TO statement 
3. Prompt again on the ’Relational database’ field. 


Use the SET CONNECTION statement to re-establish a dormant connection. 


Displaying a connection list and connection status in Query Manager 
DRDA 


To display your connections and connection states: 
1. Prompt from the Query Manager Command Line. 
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DB2 Query Manager 0S/400 
System: RCHASL7E 
Select one of the following: 


1. Work with Query Manager queries 
. Work with Query Manager report forms 
3. Work with Query Manager tables 


ine} 


10. Work with Query Manager profiles 


Query Manager Statement 


QM... 


F4=Prompt F9=Retrieve F12=Cancel F21=System command 


F3=Exit F12=Cancel F22=QM Statement 


Figure 100. Example of Query Manager Statement display 


Upon pressing F4, the list of Query Manager statements is displayed. The Query Manager connection 
statements on this display are COMMIT, DISCONNECT, RELEASE, and SET. 


2. Select the SET CONNECTION, the DISCONNECT, or the RELEASE statement. 


Select Query Manager Statement 

Select one of the following: 
1. Connect to a relational database CONNECT 
2. Commit a unit of work COMMIT 
3. Disconnect a relational database connection DISCONNECT 
4. Display the results of a query DISPLAY 
5. Draw the SQL SELECT statement from a database DRAW 
6. Erase an existing query management object ERASE 
7. Create an externalized query management object EXPORT 
8. Create an internal query management object IMPORT 
9. Print a report or a query management object PRINT 
10. Release a connection to a relational database RELEASE 
11. Run an existing query RUN 
12. Save query management data, query, or form SAVE 
13. Set the relational database connection SET 

Selection 
13 

F3=Exit F12=Cancel 


Figure 101. Example of Select Query Manager Statement display 


Upon entering option 13 on the "Select Query Manager Statement” panel, the SET CONNECTION 
prompt will display. 
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( > 
SET CONNECTION Statement 


Type choices, press Enter. 


Relational database ... Name, F4 for list 


F3=Exit F4=Prompt  F12=Cancel 


Figure 102. Example of SET CONNECTION Statement display 


Here, the user can enter the relational database name or prompt for a list of relational databases that 
are currently connected to their default activation group. 


3. Prompt again on the Relational database field. 


Pressing F4 on the Relational database field displays the current connection and a list of relational 
databases that are connected to the user’s default activation group. 


SET CONNECTION Statement 


Select Relational Database 
Current connection: DB2DSYS 


Type option, press Enter. 
1=Select 


Opt Name Description 
DB2DSYS DB2 system 
RCHASLAI iSeries Machine 
RCHASLZU iSeries Machine 
SQLMACH1 SQL/DS machine 


Bottom 
Fll=Display connection status F12=Cancel 


F3=Exit F4=Prompt F12=Cancel 


Figure 103. Example of Select Relational Database display 


If there is no current connection, then *NONE will be displayed in the Current connection field. 
4. Press F11 to display the connection status. 
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Pressing F11 on the Select Relational Database field displays connection information about the 
relational databases that are connected to user’s default activation group. 


\ 
SET CONNECTION Statement 
Select Relational Database 
Current connection: DB2DSYS 
Type option, press Enter. 
1=Select 
Opt Name Conversation Type Read-only Status 
DB2DSYS Protected NO HLD 
_  RCHASLAT Local NO HLD 
_ — RCHASLZU Not Protected VES HLD 
SQLMACH1 Protected NO RLS 
Bottom 
Fll=Display RDB description F12=Cancel 
F3=Exit F4=Prompt  F12=Cancel 2 


Figure 104. Example of Select Relational Database display with Selection Status 


If there is no current connection, then *NONE will be displayed in the Current connection field. 
Prompting on the DISCONNECT statement does not show protected conversations. 


DB2 UDB for iSeries Query Manager will support SET CONNECTION, DISCONNECT, and RELEASE 
statements as Query Manager statements. The statements can be entered by pressing F22 on most of the 
Query Manager displays. 


Understanding conversation type, read-only, and status fields in Query 
Manager DRDA 


A description of the Conversation Type, Read-only, and Status fields and their possible values are as 
follows: 


Conversation type in Query Manager DRDA 


Protected 
A protected conversation is used for the connection to a relational database on a remote system. A 
protected conversation is a conversation that uses two-phase commit protocols to ensure that, even if 
a failure occurs, updates made on the remote system are synchronized with updates to other remote 
or local resources. 


Not Protected 
The conversation used for the connection to a relational database on a remote system is not 
protected. Therefore, if a failure occurs, updates made on the remote system cannot be synchronized 
with updates to other remote or local resources. 


Local 
No conversation is used. The connection is to the local relational database. Two-phase commit 
protocols are used to ensure that, even if a failure occurs, updates made to local system are 
synchronized with updates to other remote or local resources. 
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*ARDPGM 
The connection is to a relational database accessed by an application requester driver (ARD) program. 
SQL requests directed to the relational database are processed by the ARD program specified on the 
relational database directory entry. 


Read-only in Query Manager DRDA 


YES 
Connection is read-only. If running under commitment control, updates cannot be performed over this 
connection. 


NO 
Connection is not read-only. Updates can be performed over this connection. If an update is performed 
over this connection and the connection has a Conversation Type of Local or Protected, then for this 
unit-of-work updates are also allowed to all other connections that have a Conversation Type of Local 
or Protected and do not have a Read-only value of YES. Otherwise, if an update is performed over 
this connection and it has a Conversation Type of Not protected, then updates are only allowed over 
this connection for the unit-of-work. 


Status in Query Manager DRDA 


HLD 
A held state means that a connection is not to be disconnected at the next commit operation. A 
connection is placed in the held state by the CONNECT statement. 


RLS 
A released state means that a disconnect is to occur for the connection at the next successful commit 
operation (a rollback has no affect on connections). A connection is placed in the released state from 
the held state by the RELEASE statement. A connection in the released state cannot be put into the 
held state. 


Connection management considerations in Query Manager DRDA 


The function of the CONNECT depends on the connection management method you are using. The 
methods are distributed-unit-of-work (DUW) and remote-unit-of-work (RUW). The default, unless you 
change it, is RUW. 


Table 14. CONNECT Command Differences Between *DUW and *RUW 


DUW RUW 

Multiple connections allowed One connection allowed 

CONNECT to additional database puts previous CONNECT to additional database disconnects previous 
connection in dormant state. The previous connections are connections. The previous connection or connections are 
not disconnected. disconnected before performing the connection. 
Consecutive CONNECTs to same database fails Consecutive CONNECTs to same database results in no 


current connection change 


A system running under DUW connecting to a system running under RUW may result in a read-only 
connection. 


Note: A homogenous connection is read-only as far as commitment control is concerned. A read-only 


connection is not allowed to make updates under commitment control. However, an homogenous 
read-only connection can still make non-committable updates. 
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Profile in Query Manager DRDA 


The default connection management method is RUW. The Connection Management method can be 
changed at anytime, but it only takes affect when you exit Query Manager and sign back onto DB2 UDB 
for iSeries by using STRQM. The profile value is not changed very often. Keep in mind that the connection 
management method specified does affect when connections are disconnected. 


If you specified *SYS naming conventions in your Query Manager profile, the only databases you can 
CONNECT to are those on a local machine, or those on another iSeries system. 


Work with tables connections in Query Manager DRDA 


When in Work With Tables, the connection is locked to local and cannot be changed by the CONNECT or 
SET CONNECTION statements. This is because the Work With Tables function of Query Manager only 
works with local tables. The local or the previous connection can be destroyed by the DISCONNECT or 
the RELEASE statements, or a COMMIT statement which destroys a released connection after it is 
successful. If the local connection is destroyed, then Query Manager remains in an unconnected state. 
Work With Tables uses a commitment control level of None. This does not cause any connections in a 
released state to be destroyed because a COMMIT statement is not issued. Although Query Manager 
commits all data and updates automatically, the work is not done through commitment control. To 
reconnect, you must exit out of Work With Tables. The previous connection is restored when you exit from 
Work With Tables. 


Prompted query in Query Manager DRDA 


If you change the connection from the Query Manager Command Line while creating, changing, or 
displaying a prompted query, the new connection lasts only while the command window is shown. The 
prompted query connection can be destroyed by the DISCONNECT or the RELEASE statements, or a 
COMMIT statement which destroys a released connection after it is successful. If the local connection is 
destroyed, then Query Manager remains in an unconnected state. To reconnect, you must issue a 
CONNECT statement. 


Outfile processing in Query Manager DRDA 


RUW connection management does not allow remote outfile processing. Under DUW connection 
management, remote data can be used to create an outfile on the local system. 


SET transaction considerations in Query Manager DRDA 


You can override the commitment control level by running a SET TRANSACTION statement in a DB2 UDB 
for iSeries Query. This will not change the commitment control level in your Query Manager profile. It will 
set a new commitment control level until you issue a COMMIT or ROLLBACK statement, or until another 
SET TRANSACTION is issued. The original commitment control level will be restored when a COMMIT or 
ROLLBACK is performed. For more information about commitment control, refer to the | 


Notes: 


1. If you choose change, cursor stability, all, or repeatable read you are responsible for issuing all 
COMMIT and ROLLBACK statements. For more information on the COMMIT and ROLLBACK 
statements, see page 54. 

2. You cannot choose change, cursor stability, or all, if you have not been granted authority to use the 
COMMIT and ROLLBACK statements. For information on granting authority for SQL statements, see 
page Bil 

3. You need to issue all outstanding COMMIT or ROLLBACK statements before you can start Query 
Manager. 
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4. You need to issue all outstanding COMMIT or ROLLBACK statements before you can go to the Work 
with Query Manager Tables display. While you are working with Query Manager tables, you have no 
control over when COMMIT and ROLLBACK statements are issued; Query Manager commits all data 
and updates automatically. 


5. If you choose none, and you are connected to a remote DATABASE2* (DB2*) or SQL/DS* database, 
Query Manager performs all COMMIT and ROLLBACK statements automatically when you run 
queries. DB2 and SQL/DS do not support the none commitment control level. 

6. ASET TRANSACTION statement will fail if Query Manager is connected to a remote system. 
Conversely, a CONNECT to a remote system through Query Manager will fail if a SET TRANSACTION 
statement is in effect. 
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Appendix A. Practice exercises for Query Manager 


This appendix contains exercises that lead you through the basics of Query Manager. If you are a new 
user, you can work your way through these exercises to familiarize yourself with the iSeries system and 
Query Manager. If you have not used Query Manager for a while, you might also find these exercises 
useful to refresh your memory. 


The Query Manager tasks you can perform differ depending on whether you have a BASIC or ALL access 
level assigned in your Query Manager profile. Therefore, this appendix has been divided into two parts. 


¢ Part 1 includes exercises suitable for users with BASIC or ALL access levels, including creating a table 
and adding data to it. 


* Part 2 includes exercises suitable for users with an ALL access level, including creating a query and 
report form, and running the query. 


You need to complete the exercises in Part 1 of this appendix before you can begin the exercises in Part 
2. The query and report form you create in the exercises in Part 2 use data retrieved from the table that 
you create in Part 1. 


The displays in these exercises use the terms collection, table, column, and row rather than library, file, 
field, and record. 


Exercise: Working with tables in Query Manager 


The exercises in Part 1 lead you through the following tasks: 
* Creating a table named with 18 characters or less 

* Creating a table named with 19 characters or more 

* Adding data to a table 

* Displaying individual rows from a table 

* Copying a table: creating a new table 

* Changing the definition of a copied table 

* Changing data in a table 

* Viewing table definitions 

* Deleting a table 


Work your way through these exercises in the order shown above. In most cases, in order to perform one 
exercise, you need to have completed all previous exercises. 


Exercise: Before you begin tables in Query Manager 
The first exercise leads you through the steps required to create the STAFF table shown in Table 15) 


Table 15. The STAFF Table 


ID | NAME DEPT | JOB YEARS SALARY COMM 
10 | Sanders 20 | Mgr 7 18357.50 0 
20 | Pernal 20 | Sales 8 18171.25 612.45 
30 | Marenghi 38 | Mgr 5 17506.75 0 
40 | O’Brien 38 | Sales 6 18006.00 846.55 
50 | Hanes 15 | Mgr 10 20659.80 0 
60 | Quigley 38 | Sales 0 16808.30 650.25 
70 | Rothman 15 | Sales 7 16502.83 1152.00 
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Table 15. The STAFF Table (continued) 


ID | NAME DEPT | JOB YEARS SALARY COMM 
80 | James 20 | Clerk 0) 13504.60 128.20 
90 | Koonitz 42 | Sales 6 18001.75 1386.70 
100 | Plotz 42 | Mgr 7 18352.80 0 


Create this table in your default collection or library (as specified in your Query Manager profile). The 
examples in this appendix show the table being created in a collection called MYCOLL. Your displays will 
show the table being created in your default collection or library. 


Note that you need to have *CHANGE authority for your default collection or library in order to create a 
table through Query Manager. 


The values shown in bold type are the values that you should type to complete the exercises in this 
appendix. 


Exercise: Creating a table named with 18 characters or less in Query 
Manager 
This exercise assumes that you have started Query Manager, and that the main menu is displayed. 


1. Type 3 in the Selection prompt from the main menu; then press the Enter key to show the Work with 
Query Manager Tables display. If you do not have a “Default collection for QM tables” specified in 
your Query Manager profile, you are prompted to specify the name of the collection or library you 
want to use (see page ). 


2. Type 1 in the Opt prompt next to the blank table name (at the top of the list) and press Enter to 
choose option 1 (Create table). 


3. Type STAFF in the Table prompt to name the table. An example of the Work with Query Manager 
Tables display showing the entries required to create the STAFF table is shown in Figura 104. 


Work with Query Manager Tables 


Library MYCOLL Name, F4 for list 


Type options, press Enter. 
l=Create table 3=Copy table 
6=Print table 7=Rename table 


4=Delete table 
8=Display definition 


5=Display table 
9=Add data 


10=Change data 


11=Display data 


Opt Table Description 
ve STAFF. 

APPLICANT Table of job applicants 

CARS Sample CARS Table 
__ EMPLOYEE Personnel in each in each department 
__ ORG Corp.'s organization information 
__ PRODUCT Description of corp. products 
__ SCREENS Output file for STRCPYSCN 
____-VENDINFO Vendor Information 

Bottom 

F3=Exit F4=Prompt F5=Refresh Fll=Display table only  F12=Cancel 


Fl6=Repeat position to 
Ke 


F1l7=Position to F24=More keys 


Figure 105. Tutorial: Create Table Display 
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Note: If a table called STAFF already exists in your current collection or library, you need to give the 
table you are creating a different name (for example, name it after yourself). You cannot have 
two tables, both named STAFF, in the same collection or library. 


4. Press the Enter key to go to the Create Query Manager Table display. An example of the Create 


Table display is shown in 


PN 
Create Query Manager Table 
Type choices, press Enter. 
hd DiC eaccat cerca cabestseh tec STAFF. Name 
Description: 2225-2 2 
Decimal 
Column Type Length Places 
Bottom 

F3=Exit F4=Prompt F5=Refresh Fo=Insert line F10=Copy line 
F12=Cancel Fl4=Delete line F19=Add data F24=More keys a 


Figure 106. Tutorial: Create Table Display 


5. Type The STAFF Table in the Description prompt to describe the table. You are now ready to define 
the table columns. Move the cursor to the first Column prompt. This is where you type the column 


name. 


6. Type ID as the name of the first column; then move the cursor to the Type prompt. 


7. Press F4 (Prompt) to display a list of all available data types. A prompt window opens on your 
display as shown in Figuie 107 on page 194 


Appendix A. Practice exercises for Query Manager 


191 


Create Query Manager Table 
Select Data Type 
Type option, press Enter. 
1=Select 
Opt Type Description 
BIGINT Big integer 
BLOB Binary large object 
CHARACTER Any character 
CLOB Character large object 
DATALINK Datalink 
1 DATE Date 
More... 
F12=Cancel 
Bottom 
F3=Exit F4=Prompt F5=Refresh Fo=Insert line F10=Copy line 
F12=Cancel F14=Delete line F19=Add data F24=More keys 


Figure 107. Tutorial: Create Table Display 


8. Type 1 in the Opt prompt next to “INTEGER?” to choose an integer data type; then press the Enter 
key. Query Manager inserts INTEGER into the Type prompt for ID. (An integer is a whole number 
with no decimal places.) 

You have now completed defining the first column of the table. INTEGER is a set length data type, so 
you should not specify a length for the column. (See page [16d for information on the valid lengths for 
the different data types.) 


Move the cursor to the second Column prompt, to begin defining the second column of the table. The 
display should appear as shown in Figura 10d. 


( a 
Create Query Manager Table 

Type choices, press Enter. 
Maes ie ees eee: cet cassis STAFF. Name 
Description: -. 205 s. % The STAFF Table 

Decimal 
Column Type Length Places 
ID INTEGER ae 

Bottom 

F3=Exit F4=Prompt F5=Refresh Fo=Insert line F10=Copy line 


ae eee Fl4=Delete line F19=Add data F24=More keys 


Figure 108. Tutorial: Create Table Display 
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10. 


11. 


12. 


13. 


14. 


Type NAME as the name of the second column, choose CHARACTER as its data type, and type 9 
as its length. 


Move the cursor to the third Column prompt. 


Type DEPT as the name of the third column, and choose INTEGER as its data type. Do not specify a 
length. 


Move the cursor to the fourth Column prompt. 


Type JOB as the name of the fourth column, choose CHARACTER as its data type, and type 5 as its 
length. 


Move the cursor to the fifth Column prompt. 


Type YEARS as the name of the fifth column, and choose INTEGER as its data type. Do not specify 
a length. 


Move the cursor to the sixth Column prompt. 


Type SALARY as the name of the sixth column, choose DECIMAL as its data type, type 9 as its 
length, and 2 as its number of decimal places. 


Move the cursor to the seventh Column prompt. 


Type COMM as the name of the seventh column, choose DECIMAL as its data type, type 7 as its 
length, and 2 as its number of decimal places. 


You have now finished defining the table. Your display should contain the information shown in 


aN 
Create Query Manager Table 
Type choices, press Enter. 
a Voy ogee tees perreerrs yeti acres STAFF. Name 
Description ...... The STAFF Table 
Decimal 
Column Type Length Places 
ID INTEGER 
NAME CHARACTER_ 9 — 
JOB CHARACTER_ 5 = 
DEPT. INTEGER 
SALARY DECIMAL___ 9 ray 
COMM. DECIMAL __ 7 (a 
Bottom 
F3=Exit F4=Prompt F5=Refresh Fo=Insert line F10=Copy line 
F12=Cancel Fl4=Delete line F19=Add data  F24=More keys e 


Figure 109. Tutorial: Create Table Display 


15. Press the Enter key to save your table definition. 


If you made any mistakes typing the definition values (for example, if you defined a CHARACTER 
data type with decimal places), Query Manager highlights the errors, and shows messages at the 
bottom of the display telling you how to correct each entry. You cannot save a table if it contains any 
incorrect column definition values. Correct your errors; then press the Enter key again. 


If you do make a mistake, and have trouble understanding the displayed error message, position the 
cursor on the message; then press F1 (Help). Help information is available for all Query Manager 
messages. When you finish viewing the Help display, press F12 (Cancel) to return to the Create 
Query Manager Table display. Displaying help for messages is described in 
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E 


When the table is successfully created, you see a message at the bottom of the display telling you 
the table has been created, and that you can press F19 (Add data) if you want to begin adding row 
data to the table. 


xercise: Creating a table named with 19 characters or more in Query 


Manager 
To create a table which has a name that is 19 characters or more: 


1. 


Type 3 in the Selection prompt from the main menu; then press the Enter key to show the Work with 
Query Manager Tables display. If you do not have a “Default collection for QM tables” specified in 
your Query Manager profile, you are prompted to specify the name of the collection or library you 
want to use (see page ). 


2. Type 1 in the Opt prompt next to the blank table name (at the top of the list) to choose option 


1 (Create table). An example of the Work with Query Manager Tables display showing the 1 in the 
Opt prompt shown in Figura tid 


Work with Query Manager Tables 
EVD aRYGre. heist rcuostctars escent. MYCOLL Name, F4 for list 


Type options, press Enter. 
l=Create table 3=Copy table 4=Delete table 5=Display table 
6=Print table 7=Rename table 8=Display definition 9=Add data 
10=Change data  11=Display data 


Opt Table Description 
1 
__ APPLICANT Table of job applicants 
___ CARS Sample CARS Table 
__ EMPLOYEE Personnel in each in each department 
__ ORG Corp.'s organization information 
__ PRODUCT Description of corp. products 
__ SCREENS Output file for STRCPYSCN 
_ STAFF The STAFF Table 

VENDINFO Vendor Information 

Bottom 

F3=Exit F4=Prompt F5=Refresh Fl1l=Display table only  F12=Cancel 


NC oma position to F17=Position to F24=More keys 


Figure 110. Tutorial: Create Table Display 


3. Do not type anything in the Table prompt. 
4. Press Enter. 


The Create Manager Table display appears with the cursor positioned in the blank table field. 


5. Press F24 (More keys). The F keys at the bottom of the screen have changed. 


6. Press F20 (Display entire name) The Display Entire Name display appears. An example of the 
Display Entire Name display is shown in Pore tion waged 
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Create Query Manager Table 


Type choices, press Enter. 
UC ice diatom ool ete cs Name 


Table Name 


Tab Oss ce eae oes ss = 
Bottom 
F6é=Insert line F10=Copy line F12=Cancel F14=Delete line 
F15=Split line 
Bottom 
F3=Exit F4=Prompt F5=Refresh Fé=Insert line F10=Copy line 


F12=Cancel F1l4=Delete line F19=Add data F24=More keys 


Figure 111. Tutorial: Display Entire Name Table display 


7. Type "This_is_the_Marketing_Division_Table” (the name of the table) in the Display entire name 
display. (You could type a name as long as 128 characters not including quotes.) 


8. Press the Enter key to go to the Create Query Manager Table display and enter data to create the 
table. An example of the Create Query Manager Table display with the new table name is shown in 
. Only the first eighteen characters are visible. The overflow symbol > indicates that the 
name is longer. 


> 
Create Query Manager Table 

Type choices, press Enter. 
Wablies cares sates ss "This_is_the_Market > Name 
Deseription 2.8.55: <3 6s 

Decimal 
Column Type Length Places 

Bottom 

F3=Exit F4=Prompt F5=Refresh Fo=Insert line F10=Copy line 
F12=Cancel Fl4=Delete line F19=Add data F24=More keys ) 


Figure 112. Tutorial: Create Table Display 
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You are now ready to define the table columns. 
9. Move the cursor to the first Column prompt. 
10. Do not type anything in the Column prompt. 
11. Press F24 (More keys). The F keys at the bottom of the screen have changed. 


12. Press F20 (Display entire name) The Display Entire Name display appears. An example of the 
Display Entire Name display is shown in Figura 11d 


Create Query Manager Table 


Type choices, press Enter. 
MeO ce eet a See to sents Name 


Table Name 


Type information, press Enter. 


Bottom 
F6é=Insert line F10=Copy line F12=Cancel F14=Delete line 
F15=Split line 
Bottom 
F3=Exit F4=Prompt F5=Refresh F6=Insert line F10@=Copy line 


Cree nneel Fl4=Delete line F19=Add data F24=More keys 


Figure 113. Tutorial: Display Entire Name Table display 


13. Type "This_is_the_Marketing_Division_Table” (the name of the column) in the Display entire name 
display. (You could type a name as long as 30 characters including quotes.) 

14. Press the Enter key to go to the Create Query Manager Table display and enter data to create the 
table. 


Follow the other directions as described under 


Exercise: Adding data to a table in Query Manager 
There are two ways of adding data rows to a table: 


¢ By typing 9 (Add data) on the Work with Query Manager Tables display next to the names of the tables 
to which you want to add data 


¢ By pressing F19 (Add data) immediately after you create or copy a table definition 
This exercise assumes you have completed defining the STAFF table, and that there is a message at the 
bottom of the display telling you to press F19 to add data. 


1. Press F19 (Add data) to go to the data entry display, shown in [Figure 114 on page 1971 The square 
brackets [ ] on the entry lines show you the maximum length for each value. 
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Add Data to Query Manager Table 


Table cso ys eee POARF 
Description .....: The STAFF Table 


Column Value 
ID [ 0 e| 
NAME E al 
DEPT [ 0 ] 
JOB [ J 
YEARS [20 a 
SALARY [ 0.00 | 
COMM [ 0.00 I 
Bottom 
F3=Exit F5=Refresh Fll=Display type/length F12=Cancel 


F20=Display entire name F22=QM Statement 


Figure 114. Tutorial: Add Data to Table Display 


2. Enter the values from the STAFF table columns (shown on page [189). When you finish entering the 
value for one column, press the Field Exit or Tab key to move the cursor to the prompt for the next 
column. Query Manager does not automatically advance the cursor for you, you need to move the 
cursor manually. 


3. When you complete typing all of the values that make up a row, press the Enter key. Pressing the 
Enter key saves whatever is currently shown on the display, so be careful not to press the Enter key 
before the row data is complete. If you make any errors while adding data, see page B04l for 
instructions on how to correct or complete row data. 

If Query Manager finds any mistakes in the row data (for example, if you type letters in a number 
field), it highlights the errors one at a time and shows messages at the bottom of the display telling you 
how to correct each entry. You cannot save a row that contains information that is not valid. Correct 
your errors; then press the Enter key again. 

If you do make a mistake, and have trouble understanding the displayed error message, position the 
cursor on the message; then press F1 (Help). Help information is available for all Query Manager 
messages. When you complete viewing the Help display, press F12 (Cancel) to return to the Add Data 
display. 

4. Press F11 (Display type/length) to view the definition of the STAFF table. This key is useful if you 
cannot remember what values you can enter for a particular column. 


An example of the definition display you see when you press F11 is shown in igure 115 on page 198) 
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Add Data to Query Manager Table 

ables ee Gein once TARP 
Description .... . 3: The STAFF Table 
Type information up to (]), press Enter. 

Decimal 
Column Type Length Places 
ID INTEGER 
NAME OPEN 9 
DEPT INTEGER 
JOB OPEN 5 
YEARS INTEGER 
SALARY DECIMAL 9 2 
COMM DECIMAL i 2 

Bottom 
F3=Exit F5=Refresh Fll=Display value  F12=Cancel 
F20=Display entire name F22=QM Statement 
Row added. 
= ee 


Figure 115. Tutorial: Add Data to Table Display 


When you finish viewing the definition of the table, press F11 (Display values) to return to the data 
entry display. 

5. When you complete adding all rows of data, press F3 (Exit) to leave the Add Data display, and return 
to the Work with Query Manager Tables display. Notice that the STAFF table has been added to the 
list of table names shown on this display. 


Work with Query Manager Tables 
Eo) etal ae se werereaerar Perec eterna ch MYCOLL Name, F4 for list 


Type options, press Enter. 
l=Create table 3=Copy table 4=Delete table 5=Display table 
6=Print table 7=Rename table 8=Display definition 9=Add data 
10=Change data  11=Display data 


Opt Table Description 
1 STAFF. 
__ APPLICANT Table of job applicants 
_____ CARS Sample CARS Table 
__ EMPLOYEE Personnel in each in each department 
__ ORG Corp.'s organization information 
__ PRODUCT Description of corp. products 
__ SCREENS Output file for STRCPYSCN 
___-VENDINFO Vendor Information 
Bottom 
F3=Exit F4=Prompt F5=Refresh Fl1l=Display table only  F12=Cancel 


nee position to F17=Position to F24=More keys 


Figure 116. Tutorial: Create Table Display 


Exercise: Displaying a table in Query Manager 
Now that you have created the STAFF table and added rows to it, you can display your handiwork. 
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Note: You are not able to perform this exercise if you are sath Query Manager in batch mode (see 


1. Make sure the Work with Query Manager Tables display is shown. Type 5 in the Opt SronibE next to 
the STAFE table; then press the Enter key to go to the Find Data in Query Manager Table display, as 


shown in Eigure 1171 


Note: You may need to use your display station’s roll keys to show the STAFF table in the “Work with” 


display list. 
~\ 
Find Data in Query Manager Table 

Table: 2% sae 2 as 2 STARE 
Description ..... 3: The STAFF Table 
Type search conditions, press Enter. 
No conditions entered will find all data. 
AND,OR, 

(®) Column Test Value 

( 

) 

Bottom 

F3=Exit F4=Prompt F6=Insert line F10=Copy line  F12=Cancel 
Fl4=Delete line F20=Display entire name F22=QM Statement e, 


Figure 117. Tutorial: Display Table Data Display 


Before you can display data rows from a table, you need to tell Query Manager which rows you want 
to display. You use the Find Data in Query Manager Table display to enter search conditions to find the 
rows that you want to display. Query Manager searches through the STAFF table, and displays only 
those rows that match the search conditions that you specify. 


If you press the Enter key without having defined any search conditions, Query Manager selects all 
rows from the table. For this exercise, you want to display all rows from the table. 


2. Press the Enter key to display all rows sitomn the table. (Using the Find Data display to search for 
specific rows is described in 


You see all rows from the STAFF table ina display similar to the Display Pench shown in 


lon page 200. 
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Display Report 

Width . ..: 142 
Column 2 383 1 
Control a 
LSTINGY. © Fore crest aceccrailivv crest oie ei Caeters tiie erscs vosreratev-avy ville rsayv te isrensi) erovere tie secves Onsne woot wrere vilie 

ID NAME DEPT JOB YEARS 
000001 10 Sanders 20 Mgr v 
000002 20 ~=Pernal 20 ~=Sales 8 
000003 30 Marenghi 38 Mgr 5 
000004 40 O'Brien 38 =Sales 6 
000005 50 Hanes 15 Mgr 10 
000006 60 Quigley 38 Sales 0 
000007 70 Rothman 15 Sales 7 
000008 80 James 20 Clerk 0 
000009 90 = Koonitz 42 Sales 6 
000010 100 = Plotz 42 Mgr 7 
ERE OK OR Oe EON ID) “OUR DUA T Al caste oe oe 

Bottom 


F3=Exit F12=Cancel F19=Left F20=Right F21=Split 


Figure 118. Tutorial: Display Table Data Display 


3. When you finish viewing the STAFF table, press F12 (Cancel) to leave the Display Report display and 
return to the Work with Query Manager Tables display. 
Ignore any messages that warn you that you might lose active data. The Query Manager tables 
options have no effect on active data. The only way that you can create active data in Query Manager 
is to run an SQL SELECT statement query or prompted query in interactive mode. 


Exercise: Creating a new table from a copy in Query Manager 


When you copy a table, you can create a new table or replace an existing one. You can also choose to 
make an exact copy of the table definition, or you can make modifications to the definition before the copy 
occurs. And you can copy the table definition only, or you can copy both the definition and the data rows. 


In this exercise, you will make a copy of the STAFF table, copying both the definition and the table data, 
and you will change the definition of the table before saving it. 


1. Make sure the Work with Query Manager Tables display is shown. Type 3 in the Opt prompt next to 


the_STAFF table; then press the Enter key to go to the Copy Query Manager Table display, as shown 
in Figure 119 on page Sal 
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Copy Query Manager Table 


Bromidibrarycs 3. Al ce fee | -MYCOLE 


Type information, press Enter. 


MODI DV ANY! Soe covet ee ee ey tee Ss MYCOLL Name 
Replace: ‘tablie: s).. 8. 3 oe & N Y=Yes, N=No 
Copycdata 2 3 Saw Boe als N Y=Yes, N=No 


To rename copied table, change To Table name. 


From Table To Table 
STAFF STAFF. 


Bottom 
F3=Exit F5=Refresh  F12=Cancel F20=Display entire name 
F22=QM Statement y, 


Figure 119. Tutorial: Copy Table Display 


If you have an ALL access level, the name of the collection or library that you are copying to is 
underlined, indicating that it is a prompt value that you can change. Leave the “To collection” name 
unchanged to copy the table to your default collection or library. 


2. Do not change the default value of N in response to the “Replace table” prompt. You are going to 
create a new table, not replace an existing one. 


3. Type Y in response to the “Copy data” prompt, to tell Query Manager to copy the data rows from the 
STAFF table into the newly created table. 


4. Type STAFF2 in response to the “To Table” prompt, to name the new table. 
Note: If a table called STAFF2 already exists in your default collection or library, you need to give this 
table a different name. You cannot have two tables, both named STAFF2, in the same collection 
or library. 


The al Query Manager Table display should contain the same information shown in igure 120 onl 
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Copy Query Manager Table 


Brom (brary s. se: wesc si ete ee MY COLE 


Type information, press Enter. 


TO: Mb Raryoc es: eae, eee, cee fen oe MYCOLL Name 
Replace: tablie: 3) << is 8 N Y=Yes, N=No 
Copy data: V4. a iecese ct: cet eran, sents ig Y=Yes, N=No 


To rename copied table, change To Table name. 


From Table To Table 
STAFF STAFF2 


Bottom 
F3=Exit F5=Refresh  F12=Cancel F20=Display entire name 
F22=QM Statement 
oy 


Figure 120. Tutorial: Copy Table Display 


5. Press the Enter key to perform the copy. You go to a Create Query Manager Table display, showing 
the definition for the STAFF2 table. An example of the display is shown inEigure 121 on pga 20d 
The definition and data from the STAFF table have not yet been copied to the STAFF2 table. The next 
exercise in this appendix shows you how to change the STAFF2 table definition before completing the 


copy. 
Exercise: Changing the definition of a copied table in Query Manager 


This exercise assumes that you have just copied the STAFF table, and you have not yet saved the 
definition of the newly copied STAFF2 table. Your display should appear as shown in Figure 121 of 
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Create Query Manager Table 

Type choices, press Enter. 
Tia DC eave estate ewesayst cere STAFF. Name 
Description” << 2 a2 3 The STAFF Table 

Decimal 
Column Type Length Places 
ID INTEGER = 
NAME. CHARACTER 9 
DEPT. INTEGER 
JOB CHARACTER 5 
YEARS INTEGER 
SALARY DECIMAL___ 9 2a 
COMM. DECIMAL 7 2a 

Bottom 

F3=Exit F4=Prompt F5=Refresh F6=Insert line F10=Copy line 
F12=Cancel Fl4=Delete line F19=Add data F24=More keys 


Figure 121. Tutorial: Copy Table Display 


If you choose to copy data when you copy a table, be careful not to make major changes to the table 
definition. Query Manager does its best to fit the data into the newly defined columns using the following 
guidelines: 


Data is copied when a column in the new table has the same name as a column in the old table, as 
long as the columns have compatible data types. You can change the length of the column and its 
position within the definition, but you cannot change its name or give it an incompatible data type. 
Changing the column to an incompatible data type will prevent any data in the table from being copied. 


The new columns you create are filled with default values depending on their data types (for example, 
blanks for characters and zeros for numbers). 


Query Manager discards the data from the columns that existed in the old table but do not exist in the 
new one. 


You are going to make some simple changes to the STAFF2 table definition. You will reverse the order of 
the DEPT and JOB columns, delete the YEARS column, and increase the size of the SALARY and COMM 
columns. 


1. 


Type Copy of the STAFF Table as the table description. The first change to make to the definition is 
to reverse the order of the DEPT and JOB columns. 


Position the cursor on the word JOB; then press F10 (Copy Line) to select JOB as the line you want 
to copy. 


Move the cursor to the word NAME; then press F10 (Copy Line) a second time to specify the position 
you want the line copied to. The copy line function key copies the line to the position immediately 
below the line on which the cursor is placed when you press F10 the second time. 


You now have two JOB columns in your table definition. You need to delete the JOB that you do not 
want (you cannot save a table definition that has two columns defined with the same name). 


Move the cursor to the second JOB line (the one that comes after DEPT); then press F14 (Delete 
line). This deletes the second JOB line from the definition. 


You have now reversed the order of the JOB and DEPT columns. The next thing you want to do is 
delete the YEARS column. 


Move the cursor to the YEARS line; then press F14 (Delete line). This deletes the YEARS column 
from the table definition. 
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The remaining change you want to make to the STAFF2 table before you save it is to increase the size 
of the SALARY and COMM columns. 

6. Move the cursor to the Length prompt for the SALARY column; then type 11 to increase the column 
length from 9 to 11. 

7. Move the cursor to the Length prompt for the COMM column; then type 9 to increase the column 
length from 7 to 9. 
You have now completed all of your changes to the definition of the STAFF2 table. The Create Query 
Manager Table display should appear as shown in 


a >) 
Create Query Manager Table 
Type choices, press Enter. 
Table: 235 2S: et el STAFF2 Name 
DESCription: | cs: cess or Copy of the STAFF Table 
Decimal 
Column Type Length Places 
ID INTEGER 
NAME CHARACTER _ 9 — 
JOB CHARACTER 5 
DEPT. INTEGER 
SALARY DECIMAL __ 11 ae 
COMM DECIMAL___ 9 oe 
Bottom 
F3=Exit F4=Prompt F5=Refresh F6=Insert line  F10=Copy line 
F12=Cancel Fl4=Delete line F19=Add data F24=More keys 
Press Enter to create the copied table and copy the data. 


Figure 122. Tutorial: Copy Table Display 


8. Press the Enter key to create the STAFF2 table with the definition you have just copied and changed. 
You see a message at the bottom of the display telling you that the table has been created, and that 
you can press F19 (Add data) if you want to add rows to the table. 


9. Press F3 (Exit) to leave the Create Table display, and return to the Work with Query Manager Tables 
display. Notice that STAFF2 has been added to the list of tables shown on this display. 


Exercise: Changing data in a table 


You can use the Change Data option to select, then change, the contents of individual rows in a table, and 
to delete the rows you no longer require. In this exercise, you will make changes to rows in the STAFF2 
table, deleting the row for the employee with an ID of 100, and giving pay increases to all Sales staff and 
Clerks who earn less than $18,000. 


Exercise: Searching for table rows in Query Manager 
1. Make sure that the Work with Query Manager Tables display is shown. Type 10 in the Opt prompt 
next to the STAFF2 table; then press the Enter key to go to the Find Data in Query Manager Table 
display. Before you can change data, you need to tell Query Manager which rows you want to 
ae An example of the Find Data in Query Manager Table display is shown in Eigute 12a oa] 
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Find Data in Query Manager Table 
Table cate ay sseeeen a see) STARR 
Description .... .: Copy of the STAFF Table 


Type search conditions, press Enter. 
No conditions entered will find all data. 


AND,OR, 
(&) Column Test Value 
( 
) 
Bottom 
F3=Exit F4=Prompt F6=Insert line F10=Copy line  F12=Cancel 
Fl4=Delete line F2Q=Display entire name F22=QM Statement y, 


Figure 123. Tutorial: Change Data in a Table Display 


Use this display to define search conditions that find the rows you want to change or delete. You 
need to find the employee whose ID is 100, and all employees who have a JOB of Sales or Clerk 
with a SALARY of less than $18,000. 


Notice that the search conditions start with an opening parenthesis ‘(’ and end with a closing 
parenthesis ‘)’. All searches need to start and end with parentheses. You also use parentheses to 
group search conditions, as demonstrated in this exercise. 


The first search condition that you want to define is to find the employee with an ID of 100. Move the 
cursor to the Column prompt on the first search line. 


2. Press F4 (Prompt) to display_a list of all of the columns that make up the STAFF2 table. Your display 
should appear as shown in Pe eae 
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Find Data in Query Manager Table 


Mable. eee Gore sucess —OTAREZ 
Description .... .: Copy of the STAFF Table 
H Select Column 
Type sear : 
No condit : Type option, press Enter. 
1=Select 
AND, OR, 
(,) opt Column opt Column 
(ie 1 ID SALARY 
NAME COMM 
—— JOB 
=e DEPT 
Bottom 
= F12=Cancel 
) 
Bottom 
F3=Exit F4=Prompt F6=Insert line F10=Copy line  F12=Cancel 
Fl4=Delete line F20=Display entire name F22=QM Statement 


Figure 124. Tutorial: Change Data in a Table Display 


3. Type 1 in the Opt prompt next to ID to choose the ID column; then press the Enter key. Query 


Manager inserts ID into the Column prompt. 
Move the cursor to the Test prompt. 


4. Press F4 (Prompt) to display a list of all of the supported test conditions that you can include in the 
search. Your display should appear as shown in Figura 124 
(— 2) 
Find Data in Query Manager Table 
Table 3 8 4 se eek © STARF2 
Description ..... 3: Copy of the STAFF Table 
Type search c : Select Test 
No conditions : 
: Type option, press Enter. 
AND,OR, : 1=Select 
(,) Ce: 
(& ieee Opt Test Description 
1 EQ Equal to 
_ NE Not equal to 
— GT Greater than 
a GE Greater than or equal to 
es LT Less than 
cc LE Less than or equal to 
ee Bottom 
JS F12=Cancel 
: Bottom 
F3=Exit Bidet cercVsracavenevererecienesuiere: saver srarerersi svereleteisialers ersrvaipiorsiere sts PLE =CANCel 
Fl4=Delete line F20=Display entire name F22=QM Statement ) 


Figure 125. Tutorial: Change Data in a Table Display 


5. You want to find the row where ID is equal to 100, so type 1 in the Opt prompt next to EQ; then 
press the Enter key. Query Manager inserts EQ into the Test prompt. 
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Move the cursor to the Value prompt. 


6. eee a value of 100 to complete the search condition. Your display should appear as shown in 


oN 
Find Data in Query Manager Table 

Table «4 2s ae ba f STARF2Z 
Description .....: Copy of the STAFF Table 
Type search conditions, press Enter. 
No conditions entered will find all data. 
AND,OR, 

(,) Column Test Value 

(ca he EQ_ 100 

) 

Bottom 

F3=Exit F4=Prompt F6=Insert line F10=Copy line  F12=Cancel 
Fl4=Delete line F2Q=Display entire name F22=QM Statement i 


Figure 126. Tutorial: Change Data in a Table Display 


Move the cursor to the AND, OR, (, ) prompt on the second line. In this prompt, you type either AND 


or OR to join search conditions or groups of search conditions. 


¢ Type AND if both the current and previous condition (or groups of conditions) need to be true. For 


example, you want to find all sales staff who earn less than $18,000, so JOB must equal Sales 


AND SALARY must be less than 18000. 


¢ Type OR if either the current or previous condition (or groups of conditions) needs to be true. For 


example, you want to find all sales staff and all clerks, so JOB must equal Sales OR JOB must 


equal Clerk. 


Use the opening and closing parentheses ( ) to start and end the search conditions, and again to 


start and end groups of search conditions. 


7. Press F4 a to ar i the list of the supported entries. Your display should appear as shown 
in 
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(e > 
Find Data in Query Manager Table 
Mable. ee Gore sce se —OMAREZ 
Description .....: Copy of the STAFF Table 
H Select Grouping 
Type sear : 
No condit : Type option, press Enter. 
1=Select 
AND, OR, 
(,) Opt Grouping Description 
(i AND Both conditions are true 
se 1 OR Either or both conditions are true 
= ( Begin a group 
—_ ) End a group 
=< Bottom 
ane F12=Cancel 
ye 
Bay atataccuaserezaracetuvevetorese: soatwecrare:olatecvuevoreracener eieese; acere tarts sbicrevere aveseccvers sate snes bottom 
F3=Exit F4=Prompt F6=Insert line F1l0=Copy line  F12=Cancel 
ee eeeliete line F20=Display entire name F22=QM Statement ) 


Figure 127. Tutorial: Change Data in a Table Display 


8. 


10. 


Type 1 in the Opt prompt next to OR; then press the Enter key. You want the search to select a row 
where either the ID equals 100, OR the JOB equals Sales or Clerk and the SALARY is less than 
$18,000. 

Because you want to select only those sales staff who earn less than $18,000, and only those clerks 
who earn less than $18,000, you need to enter the next three conditions as a group. Move the cursor 
to the AND, OR, (, ) prompt immediately below the OR you just entered. 

Type ( to tell Query Manager that you are defining a group of search conditions. Everything that 
comes between this opening parenthesis and its matching closing parenthesis is treated as a group. 
Because you want to find all of the sales staff and all of the clerks, and then select only those who 
earn less than $18,000, you need to create a second grouping, that joins the two JOB conditions. 
Move the cursor to the AND, OR, (, ) prompt immediately below the “(” you just entered. 

Type ( to tell Query Manager that you are defining another group of search conditions. Everything that 
comes between this opening parenthesis and its matching closing parenthesis is treated as a group. 
Move the cursor to the Column prompt. 


Your display should appear as shown in Figure 128 on page 20d. 
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Tabilie: 53 see Ae SSTARR2 
Description .... .: Copy of the STAFF Table 


Type search conditions, press Enter. 


No 


Find Data in Query Manager Table 


conditions entered will find all data. 


AND,OR, 
() Column Test Value 
(_ ID EQ 100 
) 
Bottom 
F3=Exit F4=Prompt F6=Insert line F10=Copy line  F12=Cancel 
Fl4=Delete line F2Q=Display entire name F22=QM Statement 


Figure 128. Tutorial: Change Data in a Table Display 


11. 
12. 
13. 


14. 


15. 
16. 
17. 


18. 


19. 


20. 
21. 
22. 


23. 


Type JOB as the Column name. Move the cursor to the Test prompt. 
Type EQ as the Test condition. Move the cursor to the Value prompt. 


Type Sales as the Value, telling Query Manager to search for all staff with a job of sales. When you 
search for a character value, you need to type the search value in uppercase and lowercase letters, 
exactly as it appears in the table. Move the cursor to the AND, OR, (, ) prompt. The next condition 
you define searches for all clerks. 


Type OR to tell Query Manager that either this condition OR the previous condition needs to be true 
for it to select a row. Move the cursor to the Column prompt. 


Type JOB as the Column name. Move the cursor to the Test prompt. 
Type EQ as the Test condition. Move the cursor to the Value prompt. 


Type Clerk as the Value, telling Query Manager to search for all staff with a job of clerk. Move the 
cursor to the AND, OR, (, ) prompt. 


Type ) to tell Query Manager that you have finished defining a group of search conditions. Move the 
cursor to the AND, OR, (, ) prompt on the next line. The next condition you define tells Query 
Manager to select only those sales staff and clerks who earn less than $18,000. 


Type AND to tell Query Manager that this condition AND the previous condition(s) need to be true for 
it to select a row. Move the cursor to the Column prompt. 


Type SALARY as the Column name. Move the cursor to the Test prompt. 
Type LT (less than) as the Test condition. Move the cursor to the Value prompt. 


Type 18000 as the Value, telling Query Manager to search for sales staff and clerks with a salary less 
than $18,000. Move the cursor to the AND, OR, (, ) prompt. 


Type ) to tell Query Manager that you have finished defining the group of search conditions. Your 
display should appear as shown in ome eocn ce si 
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Find Data in Query Manager Table 
Mable. ces ote cen se STAREZ 
Description .... .: Copy of the STAFF Table 


Type search conditions, press Enter. 
No conditions entered will find all data. 


AND,OR, 

(,) Column Test Value 

(ae ID EQ 100 

OR 

( 

(= JOB EQ Sales 

OR_ JOB EQ Clerk 

) 

AND SALARY. LT 18000 

) 

) 

Bottom 

F3=Exit F4=Prompt F6=Insert line F10=Copy line  F12=Cancel 
Fl4=Delete line F20=Display entire name F22=QM Statement d 


Figure 129. Tutorial: Change Data in a Table Display 


24. You have now completed defining the search conditions. Press the Enter key to begin the search. 


When Query Manager completes the search, it shows the first row it found in a Change Data in 
Query Manager Table display, as illustrated in 


(a nnn 


Change Data in Query Manager Table 


Tables 2st) <STAREZ Current row : 1 
Description : Copy of the STAFF Table 


Type information up to (+), press Enter. 


Column Value 

ID [ 60 J 
NAME [ Quigley ] 

JOB [ Sales] 

DEPT [x38 uf 
SALARY [ 17648.71 J 
COMM [ 650.25 if 


Bottom 
F3=Exit F5=Refresh Fll=Display type/length F12=Cancel 
Fl4=Previous data row F15=Next data row F16=Find data F24=More keys y 


Figure 130. Tutorial: Change Data in a Table Display 
Exercise: Changing the data in Query Manager 


You can now change the values in this display using the same rules as when you add data to a table. 
Simply type the new value for a column over the top of the existing value. 
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11. 


Type 17648.71 as the new salary for employee Quigley; then press the Enter key to save the 
changed row. 

Press F15 (Next data row) to display the next row in the selected set. 

Type 17327.97 as the new salary for employee Rothman; then press the Enter key to save the 
changed row. 

Press F15 (Next data row) to display the next row in the selected set. 

Type 14179.83 as the new salary for employee James; then press the Enter key to save the changed 
row. 

Press F15 (Next data row) to display the next row in the selected set. This is the row for employee 
Plotz whose ID is 100. This is the employee you want to delete. Notice that there is no function key 
labeled “delete” shown on the display. 

Press F24 (More keys) to display the remaining function keys that you can use with this display. 
Notice that F23 (Delete data row) is now displayed. 

Press F23 (Delete data row) to delete employee Plotz. You see a message at the bottom of the 
display telling you to press F23 a second time to confirm the delete. Press F23 again to delete the 
row. You see a message at the bottom of the display telling you that the row has been successfully 
deleted. 

Press F24 (More keys) to return to the original display of function keys. 

Press F15 (Next data row) to display the next row in the selected set. You see a message telling you 
that you are at the end of the selected set of rows. You have now completed changing all employee 
rows. 

Press F3 (Exit) to leave the Change Data option and return to the Work with Query Manager Tables 
display. 


Exercise: Viewing table definitions in Query Manager 


Query Manager presents the definition of a table in a format similar to the Create Query Manager Table 
display, showing the name, data type, length, and number of decimal places for all of the table columns. 
The definition is shown in display-only format. You cannot change any values through this option. 


1. 


Make sure the Work with Query Manager Tables display is shown. Type 8 in the Opt prompts next to 
both the STAFF and STAFF2 tables; then press the Enter key. 

When you choose more than one option from a “Work with” display, Query Manager deals with the 
options in the same order as the names appear in the list. Therefore, the Display Query Manager 
Table Definition display for the STAFF table is shown first. 
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Display Query Manager Table Definition 
i Fell 0] (= Sukrroee ate ea acorn ecxeer STAFF 
Description ..... 3: The STAFF Table 

Decimal 
Column Type Length Places 
ID INTEGER 
NAME OPEN 9 
DEPT INTEGER 
JOB OPEN 5 
YEARS INTEGER 
SALARY DECIMAL 9 2 
COMM DECIMAL 7 2 
Bottom 
Press Enter to continue. 
F3=Exit F12=Cancel F22=QM Statement 
a 


Figure 131. Tutorial: Display Table Definition Display 


2. When you finish viewing the STAFF table definition, press the Enter key to leave the display. Query 
Manager then shows the Display Query Manager Table Definition display for the STAFF2 table. 


3. When you finish viewing the STAFF2 table definition, press the Enter key to leave the display. There 
are no more tables selected through the “Work with” display, so pressing the Enter key returns you to 
the Work with Query Manager Tables display. 


Exercise: Deleting a table in Query Manager 


When you choose to delete the definition and row data of a table you no longer require, Query Manager 
shows a Confirm Delete of Table display. No tables are deleted until you respond to this display. 


1. Make sure the Work with Query Manager Tables display is shown. Type 4 in the Opt prompt next to 


the STAFF2 table; then press the Enter key to go to the Delete Table option. You see a Confirm Delete 
of Table display similar to the one shown in pou onancsod 
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Confirm Delete of Table 
FDRARY= Goce ccees. cs IMVCOLLE 


Press Enter to confirm your choices for 4=Delete. 
Press Fl2 to return to change your choices. 


Opt Table Description 
4 STAFF2 Copy of the STAFF Table 


Bottom 


Fll=Display table only F12=Cancel F20=Display entire name 


Figure 132. Tutorial: Delete Table Display 


When you press the Enter key, all of the tables listed on this display are deleted. If you want to exit 
from the display without deleting any tables, press F12 (Cancel) instead of the Enter key. 


Press the Enter key to confirm the deletion of the STAFF2 table. Query Manager deletes the table; 
then returns to the Work with Query Manager Tables display. 


You have now completed the Work with Query Manager Tables portion of these exercises. 

Press F3 (Exit) to leave the Work with Query Manager Tables display and return to the Query 
Manager main menu. 

If you have an ALL access level, you can continue with the exercises in this appendix, and create, run, 
change, and delete a query and report form. 


Exercise: Working with queries and report forms in Query Manager 


The exercises in Part 2 lead you through the following tasks: 


Creating a prompted query 

Creating an SQL query 

Saving a query: using the Exit display 
Running a query: creating active data 
Creating a report form 

Displaying a report 

Changing a prompted query 
Changing an SQL query 

Running the changed query 

Exiting without saving a query or report form 
Deleting a query 


These exercises are intended for users with an ALL access level. You need to have created the STAFF 
table from Part 1 of this appendix before you can perform any of these exercises. 
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Work your way through these exercises in the order shown above. In many cases, in order to perform one 
exercise you need to have completed all previous exercises. 


Exercise: Before you begin queries and reports in Query Manager 


The exercises in this part of the appendix lead you through the steps required to create the TUTQRY 
query and the TUTRPT report form. Instructions are provided showing you how to create and change the 
TUTQRY query in both the prompted and the SQL query creation modes. 


Note: Before you can create the TUTQRY query using the SQL query creation mode, you need to have 
autem to use ue SELECT statement ee through your Query Manager profile). See 
for details. 


Create this query and report form in your default library. The example displays in this appendix show the 
table being created in a library called MYLIB. Your displays will show the query and report form being 
created in your default library (as specified in your Query Manager profile). 


Each query and report form within a library must have a unique name. If a query named TUTQRY or a 
report form named TUTRPT already exist in your default library, you need to give the query and/or report 
form you create through these exercises different names (for example, name them after yourself). You 
cannot have two queries or two report forms with the same name in the same library. 


The values shown in bold type are the values that you should type to complete the exercises in this 
appendix. 


Exercise: Creating a prompted query in Query Manager 


Perform the following exercise if your current query creation mode is prompted. If your query creation 
mode is SQL, turn to 


This exercise leads you through the steps required to create the tutorial query (TUTQRY) shown below. 


SELECT DEPT, NAME, JOB, SALARY, COMM 
FROM MYCOLL. STAFF 
WHERE DEPT = 20 OR DEPT = 38 
ORDER BY DEPT, JOB 


The aoe query retrieves ete from the elias table elesie’ through Part 1 of this ap pendix. Turn to 


not yet eee the STAFF table. | 


1. Make sure the Query Manager main menu is displayed. Type 1 in the Selection prompt; then press 
the Enter key to go to the Work with Query Manager Queries display. 


2. Type 1 in the Opt prompt next to the blank query name (at the top of the list) to choose option 1 
(Create). 


3. Type TUTQRY in the Query name prompt to name the tutorial query; then press the Enter key to go 


to the Create option and show the Define Prompted Query display. An example of the Define 
Prompted Query display is shown in igure 133.an page 2a 
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Typ 
1 


Op 
if 


(1A Sl Vara S28 Wa Ns ea 


F3= 
F21 


Define Prompted Query 
Yio ates aes aeieeteass | SUMORY, 


e options, press Enter. Press F21 to select all. 
=Select 


t Prompted Query Selection 
Specify tables 
Define expressions 
Select and sequence columns 
Select rows 
Select sort columns 
Select summary functions 
Specify duplicate rows 
Specify report formatting 


Exit F5=Run report F6=Run sample  F12=Cancel F18=Display SQL 
=Select all F22=QM statement 


Figure 133. Tutorial: Create Prompted Query Display 


Note: If a query named TUTQRY already exists in your default library, you need to give a different 
name to the query you are creating. You cannot have two queries, both named TUTQRY, in 
the same library. 


Use the Define Prompted Query display to choose the attributes of the query that you want to define. 
You can type 1 in the Opt prompt to select individual attributes, or press F21 (Select all) to select all 
of the definition attributes. 


To create the TUTQRY query, you need to select the following attributes through the Define Prompted 
Query display: 
¢ Specify tables. Tell Query Manager that you want to query the MYCOLL.STAFF table. 


¢ Select and sequence columns. Name the columns that you want to select from MYCOLL.STAFF, 
and the sequence in which you want the columns selected. 


¢ Select rows. Specify the rows that you want the query to select. (Define the WHERE clause of the 
SELECT statement.) 


¢ Select sort columns. Specify the order in which you want the rows to be sorted. (Define the 
ORDER BY clause of the SELECT statement.) 


Type a1 in the Opt prompt beside all four of these options. The Define Prompted Query display 
should appear as shown in 
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Define Prompted Query 
QUETY samecraewcouce ges eres TUTQRY 


Type options, press Enter. Press F21 to select all. 
1=Select 


Opt Prompted Query Selection 
1 Specify tables 
Define expressions 


1 Select and sequence columns 
al Select rows 
1 Select sort columns 


Select summary functions 
Specify duplicate rows 
Specify report formatting 


F3=Exit F5=Run report F6=Run sample  F12=Cancel F18=Display SQL 
F21=Select all F22=QM statement 


Figure 134. Tutorial: Create Prompted Query Display 


5. Press the Enter key to begin defining the query. 


The first display you go to is the Specify Tables display, through which you choose the tables that you 
want to query. Displays for the remaining definition attributes are shown in the same order as the 
attribute descriptions appear on the Define Prompted Query display. 


An example of the Specify Tables display is shown in Figure 135. 


Specify Tables 
Type choices, press Enter. 


Table 22 a ea ee we ce A STAFF Name, F4 for list 
Collection S25) seed i.s MYCOLL Name 


+ for more tables .... 


F3=Exit F4=Prompt F5=Run report F6=Run sample  F12=Cancel 
F18=Display SQL F20=Display entire name F22=QM statement 


Figure 135. Tutorial: Create Prompted Query Display 
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6. Type STAFF as the name of the table you want to query, and MYCOLL as the name of the collection 
in which it resides (where MYCOLL is the name of your default collection for Query Manager tables). 
Then press the Enter key to go to the display for the next definition attribute that you chose, the 
Select and Sequence Columns display. 


You use the Select and Sequence Columns display to tell Query Manager which columns you want to 
select from the table (or tables) you chose through the Specify Tables display, and to specify the 
sequence in which you want the columns selected. An example of the Select and Sequence Columns 
display is shown in Figure iad 


= 
Select and Sequence Columns 

Type sequence number (0-9999) for the name of each column to appear in the 
report, press Enter. 
Seq Column Seq Column 

STAFF -- ALL 

A.1D 
2 ~~ A.NAME 
1 SALDEPA: 
3. ~—- A. JOB 

A.YEARS 

4_____—A.SALARY 
5 ~—-A.COMM 
F3=Exit F5=Run report F6=Run sample  F10=Duplicate column 
Fll=Display description F12=Cancel F18=Display SQL F24=More keys y 


Figure 136. Tutorial: Create Prompted Query Display 


7. Type sequence numbers in the Opt prompts beside the names of the columns that you want to be 
selected by the query. You are defining the TUTQRY query: 


SELECT DEPT, NAME, JOB, SALARY, COMM 
FROM MYCOLL.STAFF ... 


so you need to type a sequence number of 1 for DEPT, 2 for NAME, 3 for JOB, 4 for SALARY, and 5 
for COMM, as shown in igure 13d Type the sequence numbers; then press the Enter key. Notice 
that the display now lists the columns in the sequence you specified, and that the columns have been 
renumbered: 10, 20, 30, 40, 50. 


Press the Enter key a second time to go to the display for the next definition attribute that you chose, 
the Select Rows display. You use the Select Rows display to specify the rows that you want Query 
Manager to select from the specified table columns, and define the WHERE clause of the SELECT 
statement. An example of the Select Rows display is shown in 
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fe * 


Select Rows 


Type new comparison test, press Enter. 


Column or expression . A.DEPT. 


Is/Is not 4% 6 we IS IS, ISNOT 
Ne@Sitiee centered Gon career sia —_ EQs bi, LE, Gi. GE 2. 
VaillUeuaraesurenecmr acerca: 


To change previous comparison test, position cursor on 
test and press Enter. 


Previous comparison tests 
Bottom 


F3=Exit F4=Prompt F5=Run report F6=Run sample  F12=Cancel 
eal SQL  F20=Display entire name F22=QM statement 


Figure 137. Tutorial: Create Prompted Query Display 


Define the row comparison test to select only those rows that you require. You are defining the 
TUTQRY query: 


SELECT DEPT, NAME, JOB, SALARY, COMM 


WHERE DEPT = 20 OR DEPT = 38 


This means that you want to select only those rows where the DEPT is equal to either 20 or 38. 


8. Type DEPT as the name of the column for which you are defining the comparison test, and IS as the 
“Is/Is not” condition. Your display should appear as shown in Fioue iad 


9. Press F4 (Prompt) to display a list of all of the available Test Operators that you can choose. Your 
display should appear as shown in 
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Select Rows 


Select Comparison Test 


Test qualifier .. JS__ IS, ISNOT 
IS, ISNOT 
Type option, press Enter. = EQS ET LE;. Gis GE <<. 
1=Select : 
Opt Description 
1 Equal to 
_ Not equal to 
_ Greater than :sition cursor on 
_ Greater than or equal to 5 
_ Less than 
_ Less than or equal to 
More... 
F12=Cancel s 
See cey ery Cree eerie er eer eh ene ee eee er Bottom 
F3=Exit F4=Prompt F5=Run report F6=Run sample  F12=Cancel 


F18=Display SQL F20=Display entire name F22=QM statement 


Figure 138. Tutorial: Create Prompted Query Display 


10. Type 1 in the Selection prompt to choose “Equal to” and press the Enter key. Then move the cursor 
to the prompt for Value and press F4 (Prompt) to display a window through which you can enter the 
values for the comparison test. An example of this window is shown in Figure iad 


EN 
Select Rows 
Specify Comparison Test Value 
Type the value, expression, or column for comparison, press Enter. 
If A.DEPT is equal to 
20 
OR 
38 
OR 
More... 
F12=Cancel 
Bottom 
F3=Exit F4=Prompt F5=Run report F6=Run sample  F12=Cancel 
F18=Display SQL F2Q=Display entire name F22=QM statement ) 


Figure 139. Tutorial: Create Prompted Query Display 


11. Type 20 and 38 as the two test values to select all rows with a department number of 20 or 38. 
You have now finished defining the comparison test. 


12. Press the Enter key to save the test. The display should appear as shown in [Figure 140 on page 220) 
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Select Rows 


Type new comparison test, press Enter. 


AND/OR cn Wes ets —— AND, OR 

Column or expression . 

Is/Istnot: 2. > is IS, ISNOT 
WOS(ttemcectere sees mrcersias _ EQ. ETE GT. GE a2. 
Valles te semen ectrss cease 


To change previous comparison test, position cursor on 
test and press Enter. 


Previous comparison tests 
If A.DEPT is equal to 20 or 38 


Bottom 
F3=Exit F4=Prompt F5=Run report F6=Run sample  F12=Cancel 
ee ee SQL  F20=Display entire name F22=QM statement 


Figure 140. Tutorial: Create Prompted Query Display 


The comparison test you have just defined is shown at the bottom of the display, and the prompts at 
the top of the display are ready for you to define the next comparison test. 


Notice that an “AND/OR” prompt has been added to the top of the display. When you define more 
than one comparison test, you need to specify the connector you want to use to join the tests. You 
would choose AND if you wanted both tests to be true for a row to be selected, or OR if you wanted 
either of the tests to be true for a row to be selected. 


13. You have completed defining the row selection test for the query. Press the Enter key to go to the 
next definition attribute that you chose, the Select Sort Columns display. 


You use the Select Sort Columns display to specify the sort sequence for the columns being selected, 
and define the ORDER BY clause of the SELECT statement. An example of the Select Sort Columns 
display is shown in 
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Select Sort Columns 
Type sort priority (0-999) and A (Ascending) or D (Descending) for the names 
of up to 32 columns, press Enter. 
Sort Sort 
Prty A/D Column Prty A/D Column 
pt —  A.NAME 
be A A.DEPT 
oan A A.JOB 
— A. SALARY 
a A.COMM 
F3=Exit F5=Run report F6o=Run sample  F11=Display description 
F12=Cancel F18=Display SQL F20=Display entire name F22=QM statement 


Figure 141. Tutorial: Create Prompted Query Display 


14. Select each of the columns that you want to sort. Type a number from 0 to 999 to specify the priority 
for each sort. Then, type A to specify that you want to sort the column in ascending order, or D to 
specify that you want to sort the column in descending order. You are defining the TUTQRY query: 


SELECT DEPT, NAME, JOB, SALARY, COMM 


ORDER BY DEPT, JOB 


This means that you want to sort the selected columns in DEPT order, and within each DEPT, sort by 
JOB order. Type a sort priority of 1 for DEPT, and 2 for JOB. Both sorts are in ascending order (which 
is the default). Your display should appear as shown in 


15. Press the Enter key to return to the Define Prompted Query display. You have now completed all of 
the Prompted Query displays that you chose through this display, which means that you have now 
defined the TUTQRY query. Note that there is a “>” sign beside each part of the query that you have 
defined. 


16. Press F3 (Exit) to leave the Define Prompted Query display and go to the Exit display. auld save and 


describe queries using the Exit display. Turn to FEx 
RE eee oe eee oa to continue with the exercises in this appendix. 


Exercise: Creating an SQL query in Query Manager 


Perform the following exercise if your current query creation mode is SQL. If your query creation mode is 
prompted, turn to 


This exercise leads you through the steps required to create the tutorial query (TUTQRY) shown below. 


SELECT DEPT, NAME, JOB, SALARY, COMM 
FROM MYCOLL.STAFF 
WHERE DEPT = 20 OR DEPT = 38 
ORDER BY DEPT, JOB 


The TUTORY. query retrieves data from the STATE table clesiee through Part 1 of this ap pendix. Turn to 


not yet created the STAFF table. 


Appendix A. Practice exercises for Query Manager 221 


1. Make sure the Query Manager main menu is displayed. Type 1 in the Selection prompt; then press 
the Enter key to go to the Work with Query Manager Queries display. 

2. Type 1 in the Opt prompt next to the blank query name (at the top of the list) to choose 1 (Create). 

3. Type TUTQRY in the Query name prompt to name the tutorial query; then press the Enter key to go 


to the Create option and show the Edit Query display. An example of the Edit Query display is shown 
in 


ie >) 


Edit Query 
Comumns: 2: 30 as 1 68 QUENY sc si ee 2 TUTORY, 
QM... 


Type SQL Statement. 
KKRKEK EKER KKK EKEKK KER EKEKER Beginning OF data KRKKAKKKKKKKKKKKEKKKEREK 


meerenn SELECT 


KR RKKK KER KK KERE RAKE ENd OF data exe KRKAKKAKKER EKA KKK KEKE KR KKE 


Bottom 
F2=Alternate keys F3=Exit  F4=Prompt F5=Run report F6=Run sample 
Kobe Retrieve F15=Check syntax F24=More keys 


Figure 142. Tutorial: Create SQL Query Display 


This is where you type the SQL statement to define your query. 


Note: If a query named TUTQRY already exists in your default library, you need to give a different 
name to the query you are creating. You cannot have two queries, both named TUTQRY, in 
the same library. 


Make sure that the cursor is positioned in the SQL editor portion of the display, next to the ''''''' 
marks. 


4. Type SELECT to begin the query. 


If you are unsure which SQL statement you want to enter to create a query, you can press F4 
(Prompt) when the editor portion of the display is blank, to show a list of all of the SQL statements 
that you can enter through this editor. All of the SQL statements that you have been granted authority 
to use through your Query Manager profile are shown in the list (see page . You might need to 
use your display station’s roll keys to view the entire list. 


5. With the cursor on the word SELECT, press F4 (Prompt) to show a list of all the options you can 
include as part of the SELECT statement. Your display should appear as shown in igure 143 od 
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Specify SELECT Statement 


Type information for SELECT statement. 


FROM tables 
SELECT columns 
WHERE conditions 
GROUP BY columns 
HAVING conditions 
ORDER BY columns 
FOR UPDATE OF columns 


Bottom 
Type choices, press Enter. 


DISTINCT rows in result table 


UNION with another SELECT 
Specify additional options 


F3=Exit 
F10=Copy line 


F4=Prompt 
F12=Cancel 


Press F4 for a list. 


F5=Refresh F6=Insert line 
F14=Delete line 


F15=Split line 


Y=Yes, N=No 
Y=Yes, N=No 
Y=Yes, N=No 


F9=Specify subquery 
F24=More keys 


Figure 143. Tutorial: Create SQL Query Display 


You can now type values in response to the prompts on this display to define the TUTQRY query. 


6. Type MYCOLL.STAFF in response to the “FROM tables” prompt, to specify the STAFF table from 
your MYCOLL collection (where MYCOLL is the name of your default collection for Query Manager 
tables). If you are using “SYS naming conventions, type MYCOLL/STAFF. 

7. Type DEPT, NAME, JOB, SALARY, COMM in response to the “SELECT columns” prompt, to specify 
the columns you want to select from the table. 

8. Type DEPT = 20 OR DEPT = 38 in response to the “WHERE conditions” prompt, to select all rows 
with a department number of 20 or 38. 

9. Type DEPT, JOB in response to the “ORDER BY columns” prompt, to sort the selected rows by 
employee DEPT number, and within each DEPT, sort by JOB order. The display should appear as 


shown in Eigure 144 on page 224) 
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‘ > 
Specify SELECT Statement 


Type information for SELECT statement. Press F4 for a list. 


FROMitablies> <. sete sve ces fe os MYCOLL. STAFF 
SEWEGT  CoilltimnSitiss cs. csr ses ee eas DEPT, NAME, JOB, SALARY, COMM 
WHERE conditions ...... DEPT = 20 OR DEPT = 38 


GROUP: IBY *<colllmns: <<, ve i 

HAVING conditions ..... 

ORDER BY columns << . <4 s 4 DEPT, JOB 
FOR UPDATE OF columns 


Bottom 
Type choices, press Enter. 


DISTINCT rows in result table ......... N Y=Yes, N=No 
UNION wath: another SELEGH <2. 2.23 .. S. eo Si ed N Y=Yes, N=No 
Specify additional options. <2. 2452 6 5 2 a N Y=Yes, N=No 
F3=Exit F4=Prompt F5=Refresh F6=Insert line F9=Specify subquery 
tea line  F12=Cancel Fl4=Delete line F15=Split line F24=More keys y 


Figure 144. Tutorial: Create SQL Query Display 


10. When the SELECT statement options are typed correctly, press the Enter key to leave the Specify 
SELECT Statement display and return to Edit Query display. Your display should contain the query 
statement shown in Fam ig 


Note: When you use F4 (Prompt) to create or change a query, Query Manager inserts the statement 
to the Edit Query display on a single line if possible. The query statement in Eigure 144 has 
been formatted to make it easier for you to read. The query statement in your Edit Query 
display will appear as one continuous line. 


Edit Query 
Columns. 1 68 QUE IY. a sonen et ce PUMORY: 
QM... 


Type SQL Statement. 
KRKEKEKKEKEEKEEKEREEKERE BEGINNING OF data *xxxxKAAKKKKKKKKEKERKEKE 
0001.00 SELECT DEPT, NAME, JOB, SALARY, COMM 
0002.00 FROM MYCOLL.STAFF 
0003.00 WHERE DEPT = 20 OR DEPT = 38 
0004.00 ORDER BY DEPT, JOB 


KARR KEKE EK RRR RERE RR KKEREREEKRK EN OF data exe KKKK AKA KRR EKA K ARERR EERE 


Bottom 
F2=Alternate keys F3=Exit  F4=Prompt F5=Run report F6=Run sample 
ieiasd tla F15=Check syntax F24=More keys 


Figure 145. Tutorial: Create SQL Query Display 
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You have now finished defining the TUTQRY query. Press F3 (Exit) to leave the Edit Query display 
and go to the Exit display. You save and describe queries using the Exit display, as described in the 
following exercise: e C 


Exercise: Using the exit display to save a query in Query Manager 


You cannot accidentally exit from the Create Query option without saving your query. Every time you exit 
from the Edit Query or Define Prompted Query displays, you go to the Exit display which asks whether 
you want to save the query you have just created. This Exit display is also shown after you change a 
query, and after you create or change a report form. 


1. If you have not already done so, press F3 (Exit) to leave the query editor display and go to the Exit 
display. An example of the Exit display is shown in : 


Exit 
Type choices, press Enter. 

(Ojon lle) home ee aac ene eer 1 1=Save and exit 
2=Exit without save 
3=Resume without save 
4=Save and resume 

QUERY A 4s oe ee TUTQRY Name 

Bib raiyecery te centeee MYLIB Name, *CURLIB 
Description. es. Tutorial Query 
F5=Refresh  F12=Cancel 
y 


Figure 146. Tutorial: Save Query Display 


2. Type Tutorial Query as the description for this query. 


3. You want to save the query and exit from the Create Query option, so press the Enter key to accept 
the default value of 1 (Save and exit), and return to the Work with Query Manager Queries display. 
Notice that the TUTQRY query has been added to the list of queries shown on this display. 


When you save a newly created query, it becomes the active query. TUTQRY is now the active query. 


Exercise: Running a query to creating active data in Query Manager 


Now that you have created the TUTQRY query, you can run it and view the information that the query 
retrieves and sorts. Running a query interactively creates active data, which you will use in the next 
exercise in this appendix, 


Note: If your Query Manager profile is set so that you can run queries only in batch mode and “Allow 
interactive sample run” is set to NO, you cannot create active data. Active data is created only 
when a query is run interactively. 


The way you run a query can differ depending on the settings in your Query Manager profile. 
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1. Make sure that the Work with Query Manager Queries display is shown. Type 9 in the Opt prompt next 
to the TUTQRY query; then press the Enter key to go to the Run Query display, as shown in 


Run Query 


QUERY <3 Aree & : TUTQRY 
Library 2% cnc IMYETB 


Type choices, press Enter. 


Run Query Mode... 1 l=Interactive 
2=Batch 
Run sample only .. Y Y=Yes, N=No 
FOVME steerer atetes *SYSDFT_____ Name, *, *SYSDFT, F4 for list 
ibrany ee: Gees Name, *CURLIB, *LIBL 
QUED UIE: versie gered 1 1=Display, 2=Printer, 
3=Table 


ee F3=Exit F4=Prompt  F12=Cancel 


Figure 147. Tutorial: Run Query Display 


2. Alter the run options if necessary to run the query in interactive mode and send the output to display; 
then press the Enter key to run the query. Note that you can run a sample query only if “Allow 
interactive sample run” is set to YES in your Query Manager profile. Run options are described in 

44 and the “Allow interactive sample run” 


profile setting is described on page B9. 


Because you have not yet defined a report form for the TUTQRY query, Query Manager creates a 
default form (called *SYSDFT) in which to present the query data. When the query has completed 
running, its results are shown on your display. 


If you are unable to run queries in interactive mode, run the query in batch mode and send the output 
to a specified printer. No active data will be created, but you can see the result of running the query. 
Go to step tan page 27 
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Display Report 


QUERY ss See =: : MYLIB.TUTQRY Wiisdit ems se. cen 71 

FOUN: <5 ta Ge ce ten *SYSDFT Column: esc ¢ 1 

Control ee 

[TIM GS. evs caierersreil ciese etiee sos Dene oct evie Sins aes He veers Gey ene tary vee) aresvinrtvcesssiOivivne ties eis [ea 
DEPT NAME JOB SALARY COMM 

000001 20 James Clerk 13,504.60 128.20 

000002 20 Sanders Mgr 18,357.50 00 

000003 20 Pernal Sales 185070225 612.45 

000004 38 Marenghi Mgr 17,506.75 00 

000005 38 O'Brien Sales 18,006.00 846.55 

000006 38 Quigley Sales 16,808.30 650.25 


«xxx End of Data **** 


Bottom 
F3=Exit F12=Cancel Fl9=Left F2Q=Right F21=Split y, 


Figure 148. Tutorial: Run Query Display 


3. 


When you finish viewing the results of the query, press F3 (Exit) to return to the Work with Query 
Manager Queries display. 

When Query Manager runs a SELECT statement query interactively, it creates active data. In the next 
exercise in this appendix, you are going to create a report form to format the data retrieved by the 
TUTQRY query. When there is active data, Query Manager is able to supply default values (Such as 
column headings and widths) that you can use when creating your report form. 

Press F3 (Exit) to leave the Work with Query Manager Queries display and return to the Query 
Manager main menu. 


Exercise: Creating a report form in Query Manager 
This exercise leads you through the steps to create a report form for the TUTQRY query. Report formatting 


can be quite complex, and only a few of its options are described in this exercise. For a complete 


TUTQRY query. Turn to 


if you have not yet run the query. 


1. Type 2 in the Selection prompt from the Query Manager main menu; then press the Enter key to 


show the Work with Query Manager Report Forms display. 


2. Type 1 in the Opt prompt next to the blank report form name (at the top of the list) to choose option 1 


(Create). 


3. Type TUTRPT in the Form name prompt to name the tutorial report form; then press the Enter key to 


- to the Create option and show the Select Report Format display, as shown in 
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Select Report Format 
FON Stes Go: ena © UERPT 


Type options, press Enter. Press F21 to select all. 
1=Select 


Opt Report Format 

Edit column formatting 
Edit page heading 

Edit page footing 

Edit final text 

Edit break text 

Specify formatting options 


Bottom 
F3=Exit F5=Display report F12=Cancel F13=Edit query F18=Display SQL 
oe ele all F22=QM statement 


Figure 149. Tutorial: Create Report Form Display 


Note: If a report form called TUTRPT already exists in your default library, you need to give a 
different name to the report form you are creating. You cannot have two report forms, both 
called TUTRPT, in the same library. 


Use the Select Report Format display to choose the attributes of the report that you want to format. 
You can type 1 in the Opt prompts to select individual attributes, or press F21 (Select all) to select all 
attributes. 


4. Press F21 (Select all) to place a 1 in the Opt prompt for all attributes; then press the Enter key to 
show the Edit Column Formatting display. Displays for the attributes you choose are shown in the 
same order as they appear on the Select Report Format display. An example of the Edit Column 
Formatting display is shown in 
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Edit Column Formatting 

Type information, press Enter. 

For Usage and Edit, press F4 for list. 

For Heading, press F4 for prompt. 

Column Heading Usage Edit Seq  Indent Width 

DEPT DEPT 1 2 14 

NAME NAME 2 2 9 

JOB JOB 3 vA 5 

SALARY SALARY 4 2 13 

COMM COMM 5 2 10 
Bottom 

F2=Alternate keys F3=Exit F4=Prompt F5=Display sample  F6=Insert line 

F10=Copy line F1ll=Edit heading F12=Cancel F24=More keys 


Figure 150. Tutorial: Create Report Form Display 


Use the Edit Column Formatting display to control the way in which column information is arranged in 
the report. You can type headings for all columns, specify the column widths, and specify break levels 
and summary functions to include sub-totals and totals in your report. 


Note that if you could not run the TUTQRY query interactively to create active data, no default values 
are shown on the Edit Column Formatting display. The Columns and Headings are shown as 
numbers, and the Width prompts are blank. You can load default values for the Columns, Headings, 
and Widths from the active query. 

5. If your Edit Column Formatting display contains default values for Column and Heading, go to step a 
If there are no default values, press F24 (More keys). Notice that F19 (Load from query) is now 
shown on the display. 

Press F19 to load default values for Column and Heading from the active query (TUTQRY). The 
prompts for Column and Heading should now contain the information shown in : 


6. Press F11 (Edit heading) to_show a display through which you can enter column headings. Type the 
column headings shown in Eigura 151 on page 230 


When you complete typing the column headings, press F11 (Edit usage) to return to the main Edit 
Column Formatting display. 
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Edit Column Formatting 
Type information, press Enter. 
For Usage and Edit, press F4 for list. 
For Heading, press F4 for prompt. 
Column Heading 
DEPT Department 
NAME Employee Name 
JOB Job 
SALARY Salary 
COMM Commission 
Bottom 
F2=Alternate keys F3=Exit F4=Prompt F5=Display sample Fo=Insert line 
aay line Fll=Edit usage  F12=Cancel F13=Edit query F24=More keys y 


Figure 151. Tutorial: Create Report Form Display 


7. Move the cursor to the Usage prompt. You use this prompt to specify break levels, and summary 
operations such as Average, Count, Sum, Maximum, and Minimum. You can specify one usage for 
each column in the report. 

Press F4 (Prompt) to display a list of all of the supported Usage options. The More... at the bottom 
of the list indicates that there is more than one window of information. Use your display station’s roll 
keys to view the entire list. 

8. Specify a BREAK1 Usage for DEPT, a BREAK2 Usage for mele an a oom Usage for SALARY and 
COMM. Report breaks are described in detail in J c ) ; 


The next prompt on the display is Edit, through which you specify the format in which you want 
column information to appear. 

9. Move the cursor to the Edit prompt; then press F4 (Prompt) for a list of all of the formats in which 
column information can appear. (For each column, you need to specify whether the column holds 
character, numeric, graphic, or date/time data before the list of formats can be displayed.) If there is a 
More... at the bottom of a list, it indicates that there is more than one window of information. Use 
your display station’s roll keys to view the entire list. 

10. Specify an L numeric format for DEPT, an L2 numeric with 2 decimal places format for SALARY and 
COMM, and a C character format for the NAME and JOB columns. 
11. Move the cursor to the Width prompt. If you have active data, or an active query, default widths are 
shown on the display. 
Specify a width of 10 for the DEPT column, 13 for NAME, 5 for JOB, 10 for SALARY, and 10 for 
COMM. 
Leave the remainder of the formatting prompts on this display unchanged, and use the default values 
supplied by Query Manager. 
Seq specifies the sequence in which you want the columns to appear. The default is for columns to 
appear in the same order as they are retrieved by the query. 
Indent specifies the number of spaces you want to insert before the column to indent the first 
column from the edge of the page, and separate all remaining columns from the previous columns. 
The default value is two spaces. 
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Your completed Edit Column Formatting display should contain the information shown in Figure 152) 


Edit Column Formatting 


Type information, press Enter. 
For Usage and Edit, press F4 for list. 
For Heading, press F4 for prompt. 


Column Heading Usage Edit Seq Indent Width 
DEPT Department BREAK1 1 2 14 
NAME Employee Name Ain: ae) 
JOB Job break2_ emcee gre is eo) 
SALARY Salary sum 4 2 13 
COMM Commission sum 5 2 10 
Bottom 
F2=Alternate keys F3=Exit F4=Prompt F5=Display sample F6=Insert line 
F10=Copy line F1l1l=Edit heading F12=Cancel F24=More keys 


aN 


12. 


Figure 152. Tutorial: Create Report Form Display 


formatting sequence: the Edit Page Heading display. 


Press the Enter key to leave the Edit Column Formatting display, and show the next display in report 


Use the Edit Page Heading display, shown in Figure 153, to specify the text that you want to appear 


at the top of each page of the report. Note that the page heading appears only when a report is 


printed. 


Edit Page Heading 
Type choices, press Enter. 
Blank: lines: before: ss. sw 3 oe ee aes 0 0-999 
Billannike dines atten <sce csn ante kev cae gece ce 2 0-999 
Page text: Use &n, &DATE, &TIME, and &PAGE to cause variable insertion. 


Line Align Page Heading Text 
CENTER 


CENTER 


CENTER 


CENTER 


ABRWMYHH 


CENTER 


Bottom 
F2=Alternate keys F3=Exit F4=Prompt F5=Display report F6=Insert line 
Fl0=Copy line  F12=Cancel F13=Edit query F14=Delete line F24=More keys 


Figure 153. Tutorial: Create Report Form Display 
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13. The “Blank lines before” and “Blank lines after’ prompts specify the vertical position in which you want 
the page heading to appear (in relationship to the top of the page and the first detail line). Specify 0 
blank lines before, and 1 blank line after. 

14. Move the cursor to the first Line prompt, to enter the heading text for line 1. Leave the line number of 
1 and the alignment of CENTER unchanged, to center the heading on the line. Type Tutorial Report 
Form as the page heading. 

Move the cursor to the second Line prompt. You are going to enter additional heading text for line 1 
on this line. You can specify up to three values for one heading line as long as all values have 
different alignments: LEFT, CENTER, and RIGHT. 

15. Type 1 as the line number, RIGHT as the alignment, and &DATE as the heading text. (You need to 
type the word DATE in uppercase.) This causes the current date to appear on the same line as the 
report heading. The variable insertion values you can enter are described on page 27. The Edit 
Page Heading display should appear as shown in 

i a 

Edit Page Heading 

Type choices, press Enter. 

Billank kines beforecco-s, 28s, cee tes er cee Jer cece 0 0-999 

Billankeihinesmatiter pocctrcct is, sauce neces, ewe reyes os 1 0-999 
Page text: Use &col, &DATE, &TIME, and &PAGE to cause variable insertion. 
Line Align Page Heading Text 

1 CENTER Tutorial Report Form 

1 right &DATE 

3 CENTER 

4 CENTER 

5 CENTER 

Bottom 
F2=Alternate keys F3=Exit F4=Prompt F5=Display sample  F6=Insert line 
eae! line  F12=Cancel F13=Edit query F14=Delete line F24=More keys y 


Figure 154. Tutorial: Create Report Form Display 


16. 
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Press the Enter key to save the page heading information, and show the next display in report 
formatting sequence: the Edit Page Footing display. 


Use the Edit Page Footing display, shown in Figure 155 on page 239, to specify the text that you 
want to appear at the bottom of each page of the report. You use this display in the same way as the 
Edit Page Heading display. 
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Edit Page Footing 


Type choices, press Enter. 
BilankstliinesDehone? vox coe fo aev eects) sen tess 0 0-999 
Bilan: Wines? atten a. S21 seep me. Gel vee eee 0 0-999 


Page text: Use &n, &DATE, &TIME, and &PAGE to cause variable insertion. 


Line Align Page Footing Text 
RIGHT Page &PAGE 
CENTER 

CENTER 

CENTER 

CENTER 


ABWMHH 


Bottom 
F2=Alternate keys F3=Exit F4=Prompt F5=Display report F6=Insert line 
Fl0=Copy line  F12=Cancel F13=Edit query F14=Delete line F24=More keys 


Figure 155. Tutorial: Create Report Form Display 


17. Specify 0 “Blank lines before” and 0 “Blank lines after”. 


18. Move the cursor to the first Line prompt, to enter the footing text for line 1. Type an alignment of 
RIGHT, and Page &PAGE as the page footing text. (You need to type the second occurrence of the 
word PAGE in uppercase.) This causes the word “Page” followed by the page number (&PAGE) to 
appear in the bottom right-hand corner of each page. 

19. Press the Enter key to save the page footing information, and show the next display in report 
formatting sequence: the Edit Final Text display. 


Use the Edit Final Text display, shown in igure 156 on page 234, to specify the text that you want to 
appear at the end of the report. 
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(e 
Edit Final Text 
Type choices, press Enter. 
New page for final text ......... N Y=Yes, N=No 
Blank lines “before: = 3 3 4 <3 2% % * 0 0-999, BOTTOM 
Put: final: ‘summary-at: lime = 5 4% 3 «4 2 1-999, NONE 
Final text: Use &col to cause variable insertion. 
Line Align Final Text 
Lo ERT Grand_Total_-- 
2 LEFT Employee_Salaries 
3 RIGHT 
4 — RIGHT 
5 RIGHT 
6 RIGHT 
7 ~~ RIGHT 
8 RIGHT 
9 RIGHT 
10 = RIGHT 
More... 
F2=Alternate keys F3=Exit F4=Prompt F5=Display report F6=Insert line 
ey line  F12=Cancel F13=Edit query F14=Delete line F24=More keys J 


Figure 156. Tutorial: Create Report Form Display 


20. 


21. 


22. 


23. 
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You use the Edit Final Text display in the same way as the Edit Page Heading and Edit Page Footing 
displays. The only differences are that you can specify that the final text is to begin on a new page, 
and you can choose the line within the final text on which you want final summary information to 
appear. 

Type N to stop the final text appearing on a new page. Leave “Blank lines before” as 0, and type 2 to 
specify that you want summary figures (the total SUM for the Salary and Commission columns) to 
appear on the second line of the final text. 

Move the cursor to the first Line prompt. Type an alignment of LEFT, and Grand Total -- as the text 
for the first line of final text. 

Move the cursor to the second Line prompt. Type an alignment of LEFT, and Employee Salaries as 
the text for the second line of final text. 


This causes the text: 


Grand Total -- 
Employee Salaries 99999 .99 9999.99 


to appear at the end of the report. You have already specified that you want the summary figures to 
appear on the second line of final text, so the totals for the Salary and Commission columns will 
appear on the same line as “Employee Salaries”. Summary figures always appear under the column 
that they summarize. 


The Edit Final Text display should contain the information shown in Figure 156) 


Press the Enter key to save the final text information, and show the next display in report formatting 
sequence: the Edit Break Text display. 


Use the Edit Break Text display, shown in [Figure 157 on page 235) to specify the information you 
want to appear for each break level within your report form. 
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Edit Break Text 


Type options, press Enter. 
l=Heading text 2=Footing text 


Break 
Opt Level Columns with this Break Level 
1 1 DEPT 
2 2 JOB 


F2=Alternate keys F3=Exit F5=Display report 
F18=Display SQL F22=QM statement 


F12=Cancel 


Bottom 
F13=Edit query 


Figure 157. Tutorial: Create Report Form Display 


24. Type 1 beside Break level 1 to specify Heading text, and 2 beside Break level 2 to specify Footing 
text; then press the Enter key to show the Edit Break Heading display. 


You use the Edit Break Heading and Footing displays in much the same way as the Edit Page 
Heading and Footing displays. The only differences are: 


* You can force break text to begin on a new page. 


* You can repeat column headings above the detail lines for the break group. 


* You can specify the line within the break footing on which you want summary data to appear. 


An example of the Edit Break Heading display is shown in Eigure 158 on page 236. 


Appendix A. Practice exercises for Query Manager 


235 


Edit Break Heading 
Brealk: evel) (ccc: sicso ce: es dev ey stb 1 


Type choices, press Enter. 


PUE TON MEWS PAGE? xs ecey cakes ves ser cee eee. N Y=Yes, N=No 
Repeat column heading .......... N Y=Yes, N=No 
Blank dines before: o's. 2007 5 4 ew 0 0-999 
Blank dinessatiter “2 sci ve) at eo cence ces ost ete 1 0-999 


Break text: Use &col to cause variable insertion. 


Line Align Break Heading Text 

LEFT Beginning_of_department_&DEPT 
LEFT 

LEFT 

LEFT 

LEFT 


ABRWMYH 


Bottom 
F2=Alternate keys F3=Exit F4=Prompt F5=Display report F6=Insert line 
aay line  F12=Cancel F13=Edit query F14=Delete line F24=More keys 


Figure 158. Tutorial: Create Report Form Display 


25. Type N in response to the “Put on new page” prompt, to keep the new break information on the same 
page as the previous break. Type N in response to the “Repeat column heading” prompt to stop the 
column headings from being repeated under the break heading text. 


Specify 0 blank lines before the break heading, and 1 blank line after. 


26. Move the cursor to the first Line prompt, to enter the break heading text for line 1. Leave the line 
number and alignment unchanged. Type Beginning of department &DEPT as the text. When Query 
Manager prints the heading, it replaces the &DEPT variable with the value from the DEPT column in 
the current row (where the break occurs), so the current department number is inserted in the 
heading line. 

27. Press the Enter key to save the break heading information, and show the next display that you 
specified through the Edit Break Text display: the Edit Break Footing display for Break level 2. 


An example of the Edit Break Footing display is shown in 
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Edit Break Footing 
Breakzdievell gate S040 ee 2 


Type choices, press Enter. 


Putsonsimew pages 7%) is 26 fcc tes on tev a: a N Y=Yes, N=No 
Blank limes: before . «2 «4. 8 « « 6 4 « 0 0-999, BOTTOM 
Bitanik: ines; atter- 2.5210 fe Sse seh vee yee 1 0-999 

Put break summary at line ........ 1 1-999, NONE 


Break text: Use &col to cause variable insertion. 


Line Align Break Footing Text 
LEFT Total_for_job_&3; 
RIGHT 

RIGHT 

RIGHT 

RIGHT 


ABRWMYH 


Bottom 
F2=Alternate keys F3=Exit F4=Prompt F5=Display report F6=Insert line 
Fl0=Copy line  F12=Cancel F13=Edit query F14=Delete line F24=More keys 


Figure 159. Tutorial: Create Report Form Display 


28. Type N in response to the “Put on new page” prompt, to keep the footing text on the same page as 
the break detail lines. Specify 0 blank lines before the break footing, and 1 blank line after. Type 1 as 
the line number (within the break footing) at which you want the break summary information to 
appear. 


29. Move the cursor to the first Line prompt, to enter the break footing text for line 1. Type an alignment 
of LEFT, and Total for job &3 as the text. When Query Manager prints the footing, it replaces the &3 
variable with the value from column 3 in the current row (where the break occurs). Column 3 is the 
JOB column, so the current job description is inserted in the footing line. 


Because you specified that the summary data was to appear on line 1 of the break footing, the 
summary figures follow the heading: Total for job &3. 


30. Press the Enter key to save the break footing information, and return to the Edit Break Text display. 
You are going to specify both break heading text and break footing text for Break level 1. This is done 
in two separate operations. 


First, you specified the heading text for break 1. The next thing you are going to do is specify the 
footing text for break 1. Type 2 beside Break level 1 to specify Footing text for the DEPT break; then 
press the Enter key to show the Edit Break Footing display for Break level 1. shows an 
example of the Edit Break Footing display. 


31. Type N in response to the “Put on new page” prompt, to keep the footing text on the same page as 
the break detail lines. Specify 0 blank lines before the break footing, and 1 blank line after. Type 1 as 
the line number (within the break footing) at which you want the break summary information to 
appear. 


32. Move the cursor to the first Line prompt, to enter the break footing text for line 1. Type an alignment 
of LEFT, and Total for department &1 as the text. When Query Manager prints the footing, it 
replaces the &DEPT variable with the value from the DEPT column in the current row (where the 
break occurs), so the current department number is inserted in the footing line. 

Because you specified that the summary data was to appear on line 1 of the break footing, the 
summary figures follow the heading, “Total for department &1”. 

33. Press the Enter key to save the break footing information, and return to the Edit Break Text display. 
You have now finished editing break text information, so press the Enter key to progress to the next 
display in report formatting sequence: the Specify Report Formatting Options display. 
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Use the Specify Report Formatting Options display, shown in Figure 160) to specify spacing, 
separators, and other options to format your report. 


Specify Report Formatting Options 


Type choices, press Enter. 


Detail) Iine-spacing, .%. s 2 we 8 1 1-4 

Outlining for break columns ..... Y Y=Yes, N=No 
Default break textice cos. ee, Ge Sets y Y=Yes, N=No 
Column wrapped lines kept on page .. Y Y=Yes, N=No 
Column heading separators ...... Y Y=Yes, N=No 
Break summary separators ....... Ne Y=Yes, N=No 
Final summary separators ....... Y Y=Yes, N=No 


F2=Alternate keys F3=Exit F5=Display report F12=Cancel F13=Edit query 
ical! SQL F22=QM statement 


Figure 160. Tutorial: Create Report Form Display 


34. Accept the default values for all prompts. Leave all of the formatting options on this display 
unchanged to produce the report using Query Manager’s default values. (These default values are 
described on page .) 

35. Press the Enter key to save the report formatting options and return to the Select Report Format 
display. You have now completed all of the report format displays that you chose through this display. 
In the next exercise, you will run the new report form that you have just defined (but have not yet 
saved). 


Exercise: Displaying a report in Query Manager 


You can now display the report form that you created. Apply the report form to the active data to see the 
way that the definition of the report form affects the appearance of the report. 


This exercise assumes that you have active data from running the TUTQRY query, and that you have just 
completed defining the TUTRPT report form and the Select Report Format display is shown. 


Note: If your Query Manager profile is set so you can run queries only in batch mode, you cannot create 
active data. You cannot display the report, but you can run it in batch mode, and direct the output to 
a specified printer. 
1. Press the F5 key, which is labeled (Display report) if your active data is the result of running a full 
query, or (Display sample) if your active data is the result of running a sample query. An example of 
the displayed report is shown in 


If there is no active data and the F5 key is labeled (Run fepetth go to step my 
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Display Report 


QUERY ss See =: : * WIGEN «3 ~ ¢ ral 

Form 25s. 3 MYLIB.TUTRPT Column ..: 1 

Control eee 

Line: ost eecslin cote lev ets ceed occstivec 4s vag teer cs mbeessOscn ctiecc ls 
Department Employee Name Job Salary Commission 


000001 Beginning of department 20 


000002 
000003 20 James Clerk 13504.60 128.20 
000004 eee ene 0 een nnn------ 
000005 Total for job Clerk 13504.60 128.20 
000006 
000007 Sanders Mgr 18357 .50 -00 
(0) 010] |) irre 
000009 Total for job Mgr 18357.50 .00 
000010 
000011 Pernal Sales 18171.25 612.45 
0000120 eee ne eee nnn----- 
000013 18171.25 612.45 
000014 


More... 


F3=Exit F12=Cancel Fl9=Left  F2Q=Right F21=Split 


Figure 161. Tutorial: Display Report Display 


2. Use the display station’s roll keys to view the entire report. 

3. When you finish viewing the report, press F12 (Cancel) to return to the Select Report Format display. 
Go to step 4 

4. If there is no active data, the F5 key is labeled (Run report). eS F5 to go to the Run Query display. 
Choose to run the report in batch mode using the active quer , and direct the output to your default 
printer. Run options are described in i J 3 

5. In the next exercise, you will change the TUTQRY query. If you created TUTORY 2 asa seonapiad query, 
go to page B39) If you created TUTQRY as an SQL query, go to page 24d 


Exercise: Changing a prompted query in Query Manager 


Perform the following exercise if you created and saved the TUTQRY query using the prompted quer 
creation mode. If you created and saved the TUTQRY query as an SQL query, turn eRe Coenen 


In this exercise, you are going to change the definition of the active query. Instead of selecting all 
employees who work in department 20 or 38, you will select all sales staff. 


This exercise assumes that TUTQRY is the active query, that you have just displayed the TUTRPT report, 
and that the Select Report Format display is shown. 


1. Press F13 (Edit query) to leave the Select Report Format display and show the Define Prompted 
Query display containing TUTQRY, which is the active query. An example of the Define Prompted 


Query display is shown in Figure 162 on page 2401 
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Define Prompted Query 
QUETY samecraewcouce ges eres TUTQRY 


Type options, press Enter. Press F21 to select all. 
1=Select 


Opt Prompted Query Selection 
> Specify tables 
Define expressions 
> Select and sequence columns 
> Select rows 
> Select sort columns 
Select summary functions 
Specify duplicate rows 
Specify report formatting 


mR 


F3=Exit F5=Run report F6=Run sample  F12=Cancel F18=Display SQL 
F21=Select all F22=QM statement 


Figure 162. Tutorial: Change Prompted Query Display 


Notice that one of the options shown on the Define Prompted Query display is “Specify report 
formatting”. You select this option when you want to return to the Select Report Format display. 


2. Type 1 in the Opt prompt next to “Specify row selections”; then press the Enter key to go to the 
Specify Row Selections display. You use this display to create and change the row selection tests that 
tell Query Manager which rows to select from the specified table columns. An example of the Select 
Rows display is shown in 


Select Rows 


Type new comparison test, press Enter. 


AND/OR Se. te 2 et 3) sees _— AND, OR 

Column or expression . 

Is/ls nots 24% IS, ISNOT 

IERIE Gc caer are t = EQs Ibn. LE GI, GE. a. 
ValllCzar et. heresies neces 


To change previous comparison test, position cursor on 
test and press Enter. 


Previous comparison tests 
If A.DEPT is equal to 20 or 38 


Bottom 
F3=Exit F4=Prompt F5=Run report F6=Run sample  F12=Cancel 
ea SQL F20=Display entire name F22=QM statement 


Figure 163. Tutorial: Change Prompted Query Display 


You want to replace the existing comparison test with the new test: 
If A.JOB is equal to 'Sales' 
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3. Move the cursor to the “Previous comparison tests” shown on the bottom half of the display. Make sure 
that the cursor is positioned somewhere on the line that says: 


If A.DEPT is equal to 20 or 38 


then press the Enter key. The comparison test is marked by an “>” sign in the bottom half of the 
display, and is shown in the prompts in the top half of the display, as seen in 


~ 
Select Rows 

Type new comparison test, press Enter. 

Column or expression . A.DEPT. 

[s/ls not 2 2-82. 4 Is IS, ISNOT 

OSPR lees s mc wie tea wom) as EQ EO UT BES Gigs GEs ea. 

NEUIV sre eraccena coer: scteur re (20 3385 

To change previous comparison test, position cursor on 

test and press Enter. 

Previous comparison tests 
>If A.DEPT is equal to 20 or 38 

Bottom 
F3=Exit F4=Prompt F5=Run report F6=Run sample  F12=Cancel 
F18=Display SQL F20=Display entire name F22=QM statement yg 


Figure 164. Tutorial: Change Prompted Query Display 


To replace an existing comparison test with a new test, you simply type the new values over the 
existing test. 


4. Type A.JOB as the Column name. You want to select all rows where JOB is equal to ‘Sales’, so leave 
the “Is/Is not” and “Test” values unchanged. 


5. Move the cursor to the prompt for Value; then press F4 (Prompt) to show the Specify Comparison Test 
Value window. An example of this window is shown in : 
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Select Rows 
Specify Comparison Test Value 

Type the value, expression, or column for comparison, press Enter. 
If A.JOB is equal to 

'Sales' 
OR 
OR 

More... 
F12=Cancel 
Bottom 
F3=Exit F4=Prompt F5=Run report F6=Run sample  F12=Cancel 


eal SQL F20=Display entire name F22=QM statement 


Figure 165. Tutorial: Change Prompted Query Display 


6. Type ‘Sales’ as the first test value. Type blank spaces over 38 to erase the second test value. 


You need to enclose the word ‘Sales’ in single quotation marks, and type it in uppercase and 
lowercase letters, exactly as it appears in the database table. 


7. Press the Enter key to accept the changed row selection test. The test is removed from the top half of 
the display, and 


If A.JOB is equal to 'Sales' 


is shown at the bottom of the display, as a “Previous comparison test’. 
8. Press the Enter key a second time to return to the Define Prompted Query display. 


You _are now going to run the changed TUTQRY query. Turn to EEx 
SRT Eee RECEE TE to continue with the exercises in this appendix. 
Exercise: Changing an SQL query in Query Manager 


Perform the following exercise if you created and saved the TUTQRY query using the SQL query creation 
mode. If you created and saved the TUTQRY query as a prompted query, turn to 


In this exercise, you are going to change the definition of the active query. Instead of selecting all 
employees who work in department 20 or 38, you will select all sales staff. 


This exercise assumes that TUTQRY is the active query, that you have just displayed the TUTRPT report, 
and that the Select Report Format display is shown. 


1. Press F13 (Edit query) to leave the Select Report Format display and show the Edit Query display 
containing TUTQRY, which is the active query. 


2. Press F24 (More keys) to view additional function key definitions for the Edit Query display. Notice that 
the description for F13 has changed to (Edit form). You can use F13 to switch back and forth between 
the currently active SQL query and report form. 


3. Move the cursor to the part of the query that reads: 
WHERE DEPT = 20 OR DEPT = 38 
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and replace it with WHERE JOB = ‘Sales’. You need to enclose the word ‘Sales’ in single quotation 
marks, and type it in uppercase and lowercase letters, exactly as it appears in the database table. 


= 
Edit Query 

Gollumns: 5s, G38 1 68 Query. 2s. = 42> DUTORY: 
OM) 2225. 
Type SQL Statement. 

ARKEKKEKAKKEKEEKERKEEKERE BEGINNING OF data *xxxxKAAKKAKKKKKKKEKKERE 
0001.00 SELECT DEPT, NAME, JOB, SALARY, COMM 
0002.00 FROM MYCOLL.STAFF 
0003.00 WHERE JOB = 'Sales' 
0004.00 ORDER BY DEPT, JOB 

KRKKKKEKKKKEKKKKEKEKKEKRKERKRER End of data KRKKKKKKEKKEKKKEKRKKEKKEKKEEKKRKE 

Bottom 

Fl0=Cursor F13=Edit form F16=Repeat find F17=Repeat change 
F19=Left F20=Right F21=System command F24=More keys e, 


Figure 166. Tutorial: Change SQL Query Display 


You can make changes to the query by typing new or corrected values over the existing statement, or by 
pressing F4 (Prompt) to show the prompt display for the SQL statement that defines the query. You might 
need to use the F20 (Right) and F19 (Left) function keys to display the part of the query statement that 
you want to change. 


Now that you have changed the query, you can run it to view the changes you have made. Press F24 
(More keys) to view additional et key definitions for the Edit Query display. en perform the next 
exercise in this appendix: 


Exercise: Running the changed query in Query Manager 

You are now going to run the TUTQRY query, to view the changes that you made. This exercise assumes 

that you have just changed the TUTQRY query, and that the Define Prompted Query display or Edit Query 

display is shown. 

1. Press F5 (Run report) to run the query using the TUTRPT report form. 
If the “Display run options” setting in your Query Manager profile is set to NO, Query Manager runs the 
report using the default settings from your profile, and formats it using the active form (the TUTRPT 
report form that you defined). If “Display run options” is set to YES, you can now alter any run options 
you require. Type an asterisk * to run the report using the active form (TUTRPT). We suggest that you 
choose interactive mode and direct the output to display. Run options are described on page rr ad 

2. Press the Enter key to run the report. 
When the report has completed running, you either see it shown on your display, or you see a 
message at the bottom of the current display telling you the report has been sent to a printer or table. 


An example of the report generated by the changed query is shown in igure 167 on page 244) 
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Display Report 


Query =2e 6 8 MYLIBSTUTQRY: Wabi} gence cs 71 

Form <3 2.26 MYLIBSTUTRPT Column ..: 1 

Control es 

LSIMNGH esc onaidnocervearlrenc orotate clei DicretacochtsaretorS sisfegsthiese tere disvsrercdtlohersrs Ole ero ci teetevers Olszenclortve «re7er/ tc 
Department Employee Name Job Salary Commission 


000001 Beginning of department 15 


000002 

000003 15 Rothman Sales 16502 .83 1152.00 
000004 nen nen nnnnn---- 
000005 Total for job Sales 16502.83 1152.00 
000006 

(0) 01] 0) ee 
000008 Total for department 15 16502.83 1152.00 
000009 

000010 Beginning of department 20 

000011 

000012 20 Pernal Sales 18171.25 612.45 
000013 eee ene 0 een nnnnn---- 
000014 Total for job Sales 18171625 612.45 


F3=Exit F12=Cancel Fl9=Left F20=Right F21=Split 


Figure 167. Tutorial: Run Query Display 


3. If you directed the query output to display, press F3 (Exit) when you finish viewing the Display Report, 
to return to the Define Prompted Query display or the Edit Query display. If an Exit display is shown, 
choose option 1 to complete running the query and create active data. 


Exercise: Exiting without saving the query or report form in Query 
Manager 


You have now created and run a query, created a report form, displayed a report, and changed and run a 
query. You have finished most of the exercises in this part of the appendix. 


This exercise assumes you have just run the changed query, and that the Define Prompted Query display 
or Edit Query display is shown. 


1. Press F3 (Exit) to leave the query editor display and show the Exit display. An example of the Exit 
display is shown in Eigure 168 on page 244 
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Exit 
Type choices, press Enter. 


Option e384 = 2 1=Save and exit 
2=Exit without save 
3=Resume without save 
4=Save and resume 


QUERYs eos es TUTQRY Name 

Library «2 < MYLIB Name, *CURLIB 
Description .. Tutorial Query 
FROMM ss vee tecsratey os TUTRPT Name 

Librarys oso & MYCOLL Name, *CURLIB 
Description 


F5=Refresh  F12=Cancel 


Figure 168. Tutorial: Exit Display 


Notice that this Exit display shows both the changed TUTQRY query and the newly created TUTRPT 
report form. An Exit display is shown every time you create or change a query or report form. 


You want to exit from the query editor display without saving the changed query or the new report 
form, so type 2; then press the Enter key to exit without saving. Query Manager returns you to the 
Work with Query Manager Report Forms display. 

The final exercise in this appendix is to delete the TUTQRY query which you no longer require. You 
delete queries through the Work with Query Manager Queries display, so you need to exit from the 
Work with Query Manager Report Forms display, and go to the Work with Query Manager Queries 
display. 

Press F3 (Exit) to leave the Work with Query Manager Report Forms display and return to the main 
menu. 

Type 1 in the Selection prompt; then press the Enter key to go to the Work with Query Manager 
Queries display. 


Exercise: Deleting a query in Query Manager 


In this exercise you delete the TUTQRY query. When you choose to delete a query, Query Manager 
shows a Confirm Delete of Query display. No queries are deleted until you respond to this display. 


Make sure the Work with Query Manager Queries display is shown. Type 4 in the Opt prompt next to 


the TUTQRY query; then press the Enter key to go to the Confirm Delete of Query display. An example 
of this display is shown in Pore iesenpageoad 
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Confirm Delete of Query 
[DVRs ea eo essere ee see MN LET) 


Press Enter to confirm your choices for 4=Delete. 
Press Fl2 to return to change your choices. 


Opt Query Description 
4 TUTQRY Tutorial Query 


Bottom 


eS eres: query only F12=Cancel 


Figure 169. Tutorial: Delete Query Display 


When you press the Enter key, all of the queries listed on this display are deleted. If you want to exit 
from the display without deleting any queries, press F12 (Cancel) instead of the Enter key. 


2. Press the Enter key to confirm the deletion of the TUTQRY query. Query Manager deletes the query 
and returns to the Work with Query Manager Queries display. 


3. Press F3 (Exit) to leave the Work with Query Manager Queries display and return to the Query 
Manager main menu. Then press F3 (Exit) a second time to leave Query Manager and return to the 
OS/400 menu or display that was shown before you started Query Manager. 


You have completed all of the exercises in this appendix. 
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Appendix B. Query Manager statements 


This appendix describes the Query Manager statements that you can enter on the Query Manager 
statement line, through either the command window (see page ba) or the Edit Query display (see page 
(76). The one exception is the DRAW statement, which can be issued only through the Edit Query display. 


When typing in any of the following statements, you can press F4 (Prompt) while the cursor is on the 
Query Manager statement line, to display a list of the supported statements and their syntax. Depending 
on how much of the statement you have already entered, you will be prompted only for the parameters 
you have omitted. 


COMMIT CONNECT 
DISCONNECT DISPLAY 

DRAW ERASE 

EXPORT IMPORT 

PRINT RELEASE 

RUN SAVE DATA AS 
SAVE FORM AS SAVE QUERY AS 
SET CONNECTION 


The descriptions of the Query Manager statements include syntax diagrams, which show the structure of 
each statement. An example of a syntax diagram is shown below: 


>>—STATEMENT. VALUE1 >< 
| vatue2_ DEFAULT 
(—OPTIONI—= VALUE3 
'_-variable— 


¢ STATEMENT is the name (or keyword) of the Query Manager statement. You need to type the 
statement keyword exactly as shown in the diagram. 


¢ VALUE1 is on the same line as the statement keyword, so it is a required part of the statement and 
must be entered. When two or more values are joined in the same way as VALUE1 and VALUE2, you 
are being offered a choice, and can enter any one of the values shown in the diagram. For example, 
the above syntax diagram tells you to enter either STATEMENT VALUE1 or STATEMENT VALUE2. 

* OPTION1 is not on the same line as the statement keyword, so it is an optional part of the statement. 
Enter optional parts of statements only when required. The opening parenthesis shown in the syntax 
diagram needs to be typed before the option keyword. 

* DEFAULT, VALUES, and variable are the choices you can make for OPTION1. VALUE is on the same 
line as OPTION1, so you need to enter one of these choices when you specify the OPTION1 part of the 
statement. When a choice is shown above the line on which a keyword or option appears, that choice is 
the DEFAULT value. The default value is used when you do not enter the OPTION1 part of the 
statement. 

Variable values are shown in italics. Replace the variable shown in the diagram with the actual value 
that you want to use as part of the statement. For example, a variable could be the name of a table, 
report form, or query. 


COMMIT in Query Manager 


The COMMIT statement terminates a unit of recovery and commits database changes that were made by 
that unit of recovery. 
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COMMIT 


Syntax of COMMIT in Query Manager 
A syntax diagram of the COMMIT statement follows: 


>>— COMMIT 
Lot! 


>< 


HOLD Indicates a hold on resources. If specified, currently open cursors are not closed, prepared SQL 
statements are preserved, and all resources acquired during the unit of work held. Locks on 
specific rows and objects implicitly acquired during the transaction, however, are released. If 
HOLD is omitted, open cursors (except those declared with WITH HOLD clause) are closed, 
prepared SQL statements are discarded, and held resources are released. 


If the COMMIT statement is successful, all work will be committed and all connections in a 
released state will be disconnected from the default activation group. If the COMMIT statement is 
unsuccessful, the connection state of the default activation group and the states of its connections 
will be unchanged. The COMMIT statement is still allowed in Query Manager queries. 


Examples of COMMIT statement in Query Manager 
You do not need the connection to RDB1 in the next unit of work. The following statements remove the 
connection, assuming the commit operation is successful. 


RELEASE RDB1 
COMMIT 


You want to commit the changes made to RDB2 but hold the resources acquired during the current unit of 
work. 


COMMIT HOLD 


CONNECT in Query Manager 


Use the CONNECT statement to change the database under which you are running Query Manager. 
CONNECT allows you to access a database for running queries and procedures. 


The function of the CONNECT depends on the connection management method you are using. The 
methods are distributed-unit-of-work (DUW) and remote-unit-of-work (RUW). The default, unless you 
change it, is RUW. For information on changing the connection management method, see STE 


Table 16. CONNECT Command Differences Between *DUW and *RUW 


DUW RUW 

Multiple connections allowed One connection allowed 

CONNECT to additional database puts previous CONNECT to additional database disconnects previous 
connection in dormant state. The previous connections are connections. The previous connection or connections are 
not disconnected. disconnected before performing the connection. 
Consecutive CONNECTs to same database fails Consecutive CONNECTs to same database results in no 


current connection change 


For more information about Query Manager tables, prompted queries, and connection management, see 
Chapter 9 eC eC 


If you specified *SYS naming conventions through your Query Manager profile, the only databases you 
can CONNECT to are those on a local machine, or those on another iSeries system. 


The CONNECT statement is not allowed in Query Manager queries. 
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CONNECT 


Syntax of CONNECT in Query Manager 
A syntax diagram of the CONNECT statement follows: 


>>—CONNECT. RESET: 
L 10-—datdiusenaine 
(+ Options 


>< 


Options: 
| 
| 
-—* CURRENT— *NONE | 
USER—= userid: PASSWORD—=—_pas sword— 
RESET 


This option resets your database to your local database. 


TO databasename 
The name of the remote database to which the connection is to be made. You need to have been 
previously granted authority to connect to the database specified. 


USER=*CURRENT | userid 
The name of the user ID on the remote database to which the connection is to be made. The 
default value is *CURRENT, which connects to a user ID with the same name as the ID from your 
current database connection. 


PASSWORD=*NONE | password 
The password that protects the user ID to which the connection is to be made. The default value 
is *NONE. Note that you cannot have a password of *NONE if you specify a user ID other than 
“CURRENT. 


Examples of the CONNECT Statement under RUW connection 
management in Query Manager 

The following CONNECT statement creates the RDB1 connection and places it in the current state. 
CONNECT TO RDB1 


The following CONNECT statement disconnects the previous connection, creates a connection to the local 
database. 


CONNECT RESET 


The following CONNECT statement disconnects the previous connection before performing the connect. 
CONNECT TO RDB2 (USER=PARENTIS PASSWORD=SECRET 


Examples of the CONNECT statement under DUW connection 
management in Query Manager 

The following CONNECT statement creates the RDB1 connection and places it in the current state. 
CONNECT TO RDB1 


The following CONNECT statement puts the current connection in a dormant state and creates a 
connection to the local database. The local database is now the current connection. 


CONNECT RESET 


The following CONNECT statement puts the current connection in a dormant state and creates a 
connection to RDB2. Now the RDB1 and local connections are in a dormant state. 
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CONNECT 
CONNECT TO RDB2 (USER=PARENTIS PASSWORD=SECRET 


DISCONNECT in Query Manager 


The DISCONNECT statement destroys one or more connections from the default activation group. 


An identified connection must not be a connection that was used to execute SQL statements during the 
current unit of work and must not be a connection for a protected conversation. To end connections on 
protected conversations, use the RELEASE statement. 


If the DISCONNECT statement is successful, each identified connection is destroyed. If the current 
connection is destroyed, the default activation group is placed in the unconnected state. Use the 
CONNECT or SET CONNECTION statements to reestablish a connection. 


If the DISCONNECT command is unsuccessful, the connection state of the default activation group and 
the states of its connections are unchanged. 


A list of relational databases connected to the default activation group and their connection information can 
be obtained by prompting on the DISCONNECT statement. Relational databases with protected 
conversations are not displayed for this statement. 


The DISCONNECT statement is not allowed in Query Manager queries. 


Syntax of DISCONNECT in Query Manager 
A syntax diagram of the DISCONNECT statement follows: 


>>—DISCONNECT—-—rdbname >< 
CURRENT: 
'_ALL——— 
rdbname The name of the relational database (rdb) that is currently being accessed. An rdbname 


can be up to 18 characters in length and can only consist of uppercase letters, numerics, 
or an underscore. The first character must be an uppercase letter. 


CURRENT Identifies the current connection of the activation group. 


ALL Identifies all connections in the default activation group. 


Examples of the DISCONNECT statement in Query Manager 


The connection to RDB1 is not needed in the next unit of work. The following statement is run after a 
commit operation. 


DISCONNECT RDB1 


The current connection is not needed in the next unit of work. The following statement is run after a 
commit operation. 


DISCONNECT CURRENT 


None of the existing connections are needed in the next unit of work. The following statement is run after 
a commit operation. 


DISCONNECT ALL 
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DISPLAY 
DISPLAY in Query Manager 


Use the DISPLAY statement to apply a report form to the active data that was generated from the most 
recent interactively run SQL SELECT statement query or prompted query. If there is no active data, an 
error message is displayed. See page |& for information about active data. 


Note: If your Query Manager profile is set so you can run queries only in batch mode and “Allow 
interactive sample run” is set to NO, you cannot create active data, so you cannot use the 
DISPLAY statement. 


To run a sample you can either: 


* Select option 9 (Run) from the Work with Query Manager Queries display; then set the Run Sample 
prompt to Y on the Run Query display. 


* Select option 9 (Run report) from the Work with Query Manager Report Forms display; then set the Run 
Sample prompt to Y on the Run Query display. 


* Press F6 (Run sample) from the Edit Query or Display Query display. 
* Press F6 (Run sample) from any of the Define Prompted Query or Display Prompted Query displays. 


¢ Press F5 (Run report) from any of the Select Report Format or Display Report Format displays; then set 
the Run Sample prompt to Y on the Run Query display. 


Syntax of DISPLAY in Query Manager 
A syntax diagram of the DISPLAY statement follows: 


>>— DISPLAY REPORT. >< 
L sampLe I —*SYSDFT 
(—FORM—= * 
—name 


REPORT This option displays a full report, using the specified report form applied to the active data. 
If there is no active data, or if there is sample active data as the result of running an SQL 
SELECT statement query or prompted query with the sample restriction, an error message 
is displayed. 


SAMPLE This option displays a sample report, using the specified report form applied to the active 
sample data. If there is no sample data, an error message is displayed. 


FORM=*SYSDFT | * | name 
The name of the report form to be applied to the active data. If you omit the FORM option, 
Query Manager generates a default report form (*SYSDFT). The report form can be 
specified as: 


*SYSDFT 
A simple default report form, generated from the active data. See [Report forms id 
‘SUR RAER CCRT: for a description of the *“SYSDFT report form. 

* The active form. (The last report form that was created or changed, or used to 
format an SQL SELECT statement query or prompted query.) 


name_ The name of the report form to be used, and the name of the library where it 
resides. If you do not specify a library name, the default library for query objects 
specified in your Query Manager profile is searched for the named report form 
when the statement is run. You can specify the name of the report form and library 
in one of the following ways: 


* library.formname Use this format if your Query Manager profile specifies that 
you use the SQL naming convention. 
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* library/formname Use this format if your Query Manager profile specifies that 
you use the system naming convention. Specify *LIBL to search your library list. 


Examples of DISPLAY statement in Query Manager 
DISPLAY REPORT (FORM=*« 


DISPLAY SAMPLE 


DISPLAY REPORT (FORM=SMITH.SAL_REPT 


DRAW in Query Manager 


The DRAW statement is allowed only in the Edit Query display. It builds an SQL SELECT statement for a 
named table, and adds this statement to any text that exists in the display. The SELECT statement names 
columns explicitly rather than using the asterisk (*). Column names, library names, and table names that 
are reserved words will be quoted. 


SELECT "YEARS", COL1, COL2 FROM SMITH."TABLE" 


Syntax of DRAW in Query Manager 


A syntax diagram of the DRAW statement follows: 
>>—DRAW—tablename >< 


tablename The name of the table from which the SELECT statement is to be constructed, and the 
name of the library (or collection) in which it resides. If you do not specify a library (or 
collection) name, the default library for query objects specified in your Query Manager 
profile is searched for the named table when the statement is run. You can specify the 
name of the table and library (or collection) in one of the following ways: 


* collection.tablename Use this format if your Query Manager profile specifies that you 
use the SQL naming convention. 


¢ library/filename Use this format if your Query Manager profile specifies that you use 
the system naming convention. Specify *LIBL to search your library list. 


Examples of DRAW Statement in Query Manager 
DRAW STAFF 


DRAW SMITH. STAFF 


DRAW SMITH.STAFF_CHICAGO_MANAGERS_SALESPLAN_ 1994 


ERASE in Query Manager 


The ERASE statement removes a report form, procedure, query, or table from the database. 


Syntax of ERASE in Query Manager 


A syntax diagram of the ERASE statement follows: 


>>— ERASE FORM name | >< 
PROC (—CONFIRM—=—_—YES 
QUERY | wo] 
TABLE 
name The name of the report form, procedure, query, or table to be removed, and the name of 


the library where it resides. If you do not specify a library name, the default library for 
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ERASE 


query objects specified in your Query Manager profile is searched for the object when the 
statement is run. You need to have the appropriate ownership and database or query 
authorization to remove an object. You can specify the name of the object and library in 
one of the following ways: 


* library.objectname Use this format if your Query Manager profile specifies that you use 
the SQL naming convention. 

* library/objectname Use this format if your Query Manager profile specifies that you 
use the system naming convention. Specify *LIBL to search your library list. 


CONFIRM=YES | NO 


This option provides for a check before performing your ERASE request. If the option is 
set to YES, you are prompted to confirm that the existing object is to be erased. If the 
option is set to NO, the erase occurs without confirmation. 


The default value is YES. The default can be changed in your Query Manager profile (see 


Examples of ERASE statement in Query Manager 


ERASE TABLE EMP 


ERASE TABLE SMITH.EMP (CONFIRM=YES 


EXPORT in Query Manager 


The EXPORT statement is used to create a file containing the contents of certain Query objects. The 
following objects can be exported: report form, procedure, and query. 


Syntax of EXPORT in Query Manager 
A syntax diagram of the EXPORT statement follows: 


>>— EXPORT. FORM name—T0—filename >< 
PROC *FIRST a aa Options H 
QUERY member. ) 

Options: 


| 
LcoNEIRM_= con L eainnent—a— Fae! J 
NO 


name 


The name of the report form, procedure, or query to be exported, and the name of the 

library where it resides. If you do not specify a library name, the default library for query 

objects specified in your Query Manager profile is searched for the object when the 

statement is run. You can specify the name of the object and library in one of the following 

ways: 

* library.objectname Use this format if your Query Manager profile specifies that you use 
the SQL naming convention. 


¢ library/objectname Use this format if your Query Manager profile specifies that you 
use the system naming convention. Specify *LIBL to search your library list. 


filename (member) 


The name of the system file (and member) that receives the exported object. If you do not 
specify a member, *FIRST is used (that is, the first member in the specified file). 
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EXPORT 


To be consistent across systems, you should not specify more than a single file name 
without library names or extensions. This allows system defaults to take effect. 


Query Manager qualifies the single name to fit the data naming requirements of the 
operating environment. 


You need to be aware of these naming restrictions when transporting Query Manager 
objects between operating environments. 


CONFIRM=YES | NO 


This option provides for a check before performing your EXPORT request. If the existing 
file is about to be replaced and the option is set to YES, you are prompted to confirm the 
replacement. If the option is set to NO, the replacement takes place automatically. 


The default value is YES, but you can change the default in your Query Manager profile 
(see 


COMMENT= ‘text’ 


Use this option to supply a comment to describe the exported FORM, PROC, or QUERY. 
If the comment contains multiple words or imbedded blanks, you need to enclose it in 
single quotation marks. Quotation marks within the comment need to be entered as two 
adjacent single quotation marks: 


COMMENT='January's sales figures' 


Examples of EXPORT statement in Query Manager 
EXPORT QUERY SAMP1 TO SAMP1EX 


EXPORT FORM EX 


IMPORT i 


LIB/EX1 TO EXLIB/FILE(EX1F) (CONFIRM=YES 


n Query Manager 


You can use the IMPORT statement to copy a file containing an exported object into a report form, 


procedure, or 


query. The IMPORT statement does not affect the external file. 


Syntax of IMPORT in Query Manager 
A syntax diagram of the IMPORT statement follows: 


>>— IMPORT. 


( 


PROC 


—QUERY— 


FORM name—FROM—filename L 
( 


*FIRST: | 
ember 


Sort Opt 


Confirm/Com 
| 


>< 
Confirm/Comment Options 
ions 


ment Options: 


CONFIRM 


Sort Options: 


= YES | COMMENT—=—’ text’ 
ai 
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IMPORT 


| 

| *SRC *SRC il | 
SRTSEQ—= * JOBRUN LANGID—= * JOBRUN— 

*JOB *JOB 
t-* LANGIDSHR lang id— 
t—* LANGIDUNQ 
*HEX: 
t-*LIBL/—*CURLIB/—library— — 
table 


name_ The name of the report form, procedure, or query to be imported, and the name of the library in 
which it resides. If you do not specify a library name, the default library for query objects specified 
in your Query Manager profile is searched for the object when the statement is run. You can 
specify the name of the object and library in one of the following ways: 


¢ library.objectname Use this format if your Query Manager profile specifies that you use the 
SQL naming convention. 


¢ library/objectname Use this format if your Query Manager profile specifies that you use the 
system naming convention. Specify *LIBL to search your library list. 


filename (member) 
The name of the system file (and member) that Query Manager is to read (that is, the source file 
for the imported object). If you do not specify a member, *FIRST (the first member in the specified 
file) is used. 


In order to be consistent across systems, do not specify more than a single name without library 
names or extensions; you need to allow system defaults to be taken. 


CONFIRM=YES | NO 
This option provides for a check before performing your IMPORT request. If an existing object in 
the database is about to be replaced and the option is set to YES, you are prompted to confirm 
that the existing object is to be replaced. If the option is set to NO, replacement occurs without 
confirmation. 


The default value is YES, but you can change the default in your Query Manager profile (see 


COMMENT= ‘tex?’ 
Use this option to supply a comment to describe the imported FORM, PROC, or QUERY. If the 
comment contains multiple words or imbedded blanks, you need to enclose it in single quotation 
marks. Quotation marks within the comment need to be entered as two adjacent single quotation 
marks: 


COMMENT='Bernie's greatest work' 


SRTSEQ=SRC | *JOBRUN | *JOB | *LANGIDSHR | *LANGIDUNQ | *HEX | table 
Use this option to specify the sort sequence to use for this query. The SRTSEQ parameter is 
allowed only when importing a QUERY. The possible values are: 


*SRC The source file member contains the sort sequence specification. If the source file 
member does not contain the sort sequence, *JOBRUN is used. *SRC is the 
default if you do not specify SRTSEQ. 


*JOBRUN Use the SRTSEQ associated with the job at the time you run the query. 
*JOB Use the SRTSEQ associated with the job at the time you import the query. 


*LANGIDSHR Use the sort sequence table that is associated with the language specified by the 
LANGID parameter, and that shares collating weights between some characters. 


*LANGIDUNQ Use the sort sequence table that is associated with the language specified by the 
LANGID parameter, and that has unique collating weights for all characters. 


Appendix B. Query Manager statements 255 


IMPORT 
*HEX Use the binary value of the characters for the sort sequence. 
table Use this external sort sequence table object. 


LANGID=SRC | *JOBRUN | *JOB | Lang /D 
Use this option to specify the language for the query. LANGID specifies what sort sequence table 
to use when you specify *LANGIDSHR or *LANGIDUNQ for the SRTSEQ parameter. The possible 
values are: 


*SRC The source file member contains the language identifier. If the source file member 
does not contain the language identifier, *JOBRUN is used. *SRC is the default if 
you do not specify LANGID. 


*JOBRUN Use the LANGID associated with the job at the time you run the query. 
*JOB Use the LANGID associated with the job at the time you import the query. 


Lang ID The three-character language identifier. 


The IMPORT statement is typically used in the following situations: 


* To copy report form, procedure, and query objects from one Query Manager installation to another 
(objects are exported by the sending installation and imported by the receiving installation). 


* To use a full-function editor outside Query Manager. 


¢ For users who want to migrate SQL queries from program libraries that typically reside outside Query 
Manager to libraries inside Query Manager for purposes of modification and interactive processing. 


The IMPORT statement copies the contents of the specified file into the database. For SQL queries and 
procedures, each record in the file becomes a separate line in the object. All files that were exported using 
the Query Manager EXPORT statement can be imported. When importing files containing SQL queries 
and procedures, Query Manager accepts records having a logical record length greater than 79 even 
though the resulting data may be truncated. If Query Manager finds a logical record length greater than 
79, it displays a warning message. 


If the imported file has a fixed record format (and a logical record length greater than 79), then Query 
Manager accepts only data in positions 1 to 79 and ignores the rest. 


When importing files with a logical record length less than 79, Query Manager does not perform any 
validation or semantic checking on the contents of the files. Therefore, it is possible to establish query and 
procedure objects containing non-displayable characters. (This could happen if a program’s object file 
were imported as a query). Also, it is possible to import SQL statements into the PROC object and vice 
verse. It is your responsibility to avoid such mistakes, because Query Manager contains no provision for 
“re-categorizing” contents. 


Query Manager validates FORM objects. If some part of the file fails a validation test, the object is brought 
into the database and a warning messages are issued. It is possible for the file to pass the validation test, 
yet supply unpredictable results when used for formatting. 


Examples of IMPORT statement in Query Manager 
IMPORT FORM REPORT1 FROM REPT1EX 


IMPORT QUERY SALARYWK FROM JENSON 


PRINT in Query Manager 


You can use the PRINT statement to print a hard copy of a report form, procedure, query, or report. The 
following objects print as they are written: report forms, procedures, and queries. If you select to print a 
report, the report is applied to the active data produced by the last interactively run SQL SELECT 
statement query or prompted query. If there is no active data, an error message is returned. 
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PRINT 
Syntax of PRINT in Query Manager 


A syntax diagram of the PRINT statement follows: 


>>—PRINT. FORM name L >< 
[ proc (—PRINTER—=—-printernane—| 
QUERY * JOB. 


A syntax diagram of the PRINT REPORT statement follows: 


>>—PRINT—REPORT 
=| Options = 


>< 


Options: 


[> 
ORs Forandme| * SYSDFT | *SYSDFT | 
WIDTH—= max_char_per_line LENGTH—= max_number_lines— 


> PRINTER—= printername 
I al aa L308 _—___| 
PAGENO—= NO —DATETIME—= NO: 


name The name of the report form, procedure, or query to be printed, and the name of the library where 
it resides. If you do not specify a library name, the default library for query objects specified in 
your Query Manager profile is searched for the object when the statement is run. You can specify 
the name of the object and library in one of the following ways: 


¢ library.objectname Use this format if your Query Manager profile specifies that you use the 
SQL naming convention. 


¢ library/objectname Use this format if your Query Manager profile specifies that you use the 
system naming convention. Specify *LIBL to search your library list. 


PRINTER=*JOB | printername 
The printer that produces the printed output. The default is the printer specified in your Query 
Manager profile. *JOB uses the printer specified in your current job. 


FORM=formname 
The name of the report form that you want to print. If no report form is specified, the form used in 
the last RUN QUERY that produced the currently active data is used. 


WIDTH=*SYSDFT | max characters per print line 
An integer between 22 and 378 inclusive to specify the width of the page. 


If you do not specify WIDTH, Query Manager uses the corresponding_system or user default 

*SYSDFT). If this value is unavailable, the default is set to 80. (See 
for a description of the *SYSDFT default values.) 

Reports wider than the print width specified are split between pages. Query objects wider than the 


print width specified are truncated on the right. Make sure the width you specify is compatible with 
the printer you are using. 


LENGTH=*SYSDFT | maximum number of lines per page 
A number between 1 and 255 inclusive to specify the length of the page. 


The default is the corresponding system or user default (*“SYSDFT). If this value is not available, 
the default is set to 66. (See on page 4 for a description of the 
*“SYSDFT default values.) 
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PRINT 


If a report is specified, and the value for LENGTH is less than the total number of lines needed for 
column headings, page headings and footings, plus the line needed to print the page number and 
date and time, an error message is generated and the report is not printed. 


If the LENGTH value is adequate for the report, Query Manager performs a page eject whenever 
the number of lines of data printed on a page equals the LENGTH value specified. 


PAGENO=YES | NO 
This option controls the printing of page numbers on the last line of each page. The default is 
YES. 


DATETIME=YES | NO 
This option controls the generation and display of the system date and time on the bottom of each 
page. If YES, the date and time are placed on the last line of each page. If NO, the system date 
and time do not print. The default is YES. 


Examples of PRINT statement in Query Manager 
PRINT QUERY MYLIB.STAFF 


PRINT PROC PAYROLL 


PRINT REPORT (WIDTH=80 LENGTH=60 DATETIME=YES PAGENO=YES 


RELEASE in Query Manager 


The RELEASE statement places one or more connections in the released state. A released state can be 
thought of as a pending disconnect. When a connection is in the released state, this means that a 
disconnect will occur at the next successful commit operation. A disconnect will not occur at the next 
rollback because rollbacks have no effect on connections. 


If the RELEASE command is successful, each identified connection is placed in the released state and will 
be disconnected at the next successful commit operation. If the current connection is in the released state 
when a commit operation runs successfully, the connection is destroyed and the default activation group is 
left in an unconnected state. Use the CONNECT or the SET CONNECTION statements to reestablish a 
connection. 


If the RELEASE command is unsuccessful, the connection state of the activation group and the states of 
its connections are not changed. 


A list of relational databases connected to the default activation group and their connection information can 
be obtained by prompting on the RELEASE statement. The RELEASE statement statement can be used 
on protected conversations. 


The RELEASE statement is not allowed in Query Manager queries. 


Syntax of RELEASE in Query Manager 
A syntax diagram of the RELEASE statement follows: 


>>—RELEASE rdbname 
current 
ALL. 


>< 


rdbname The name of the relational database (rdb) that is currently being accessed. An rdbname 
can be up to 18 characters in length and can only consist of uppercase letters, numerics, 
or an underscore. The first character must be an uppercase letter. 


CURRENT Identifies the current connection of the activation group. 
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RELEASE 


ALL Identifies all connections in the default activation group. 


Examples of the RELEASE statement in Query Manager 

The connection to RDB1 is not needed in the next unit of work. The following statement causes it to be 
removed at the next successful commit operation. 

RELEASE RDB1 


The current connection is not needed in the next unit of work. The following statement causes it to be 
removed at the next successful commit operation. 


RELEASE CURRENT 


None of the existing connections are needed in the next unit of work. The following statement causes 
them to be removed at the next successful commit operation. 


RELEASE ALL 


RUN in Query Manager 


The Query Manager RUN statement processes a procedure or query. When you enter the RUN statement, 
you need to identify the procedure or query, and that query or procedure needs to exist in the database. If 
used to process an SQL SELECT statement query or prompted query, the RUN QUERY statement allows 
you the option of specifying the active query and the active form. If there is no active query or active form, 
you need to provide the query and report form name. When you process the statement, the query and 
report form specified become the active query and active form. If you choose to display the results, you 
should also select a report form. 


Notes: 


1. If you run queries in batch mode, the Display parameter cannot be YES. A report is spooled to the 
nee aie in your Query Manager profile (see 


2. If you run queries interactively and you set the DISPLAY option to NO, the only outcome of processing 
the statement is the creation of active data. 


3. You can use this statement to run any prompted query, but you can run only those SQL queries that 
contain SQL statements that you have been granted authority to use through your Query Manager 
profile (see 


Syntax of RUN in Query Manager 
A syntax diagram of the DISCONNECT statement follows: 


>>—RUN PROC—name | >< 
QUERY name 
Ee i Options H 
Options: 

| 
| 

* SYSDFT DISPLAY—= YES. | 

FORM—= * L yo! 


—name 


name The name of the query or procedure to be run, and the name of the library where it resides. If you 
do not specify a library name, the default library for query objects specified in your Query Manager 
profile is searched for the object when the statement is run. You can specify the name of the 
object and library in one of the following ways: 
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RUN 


¢ library.objectname Use this format if your Query Manager profile specifies that you use the 
SQL naming convention. 

¢ library/objectname Use this format if your Query Manager profile specifies that you use the 
system naming convention. Specify *LIBL to search your library list. 


ei Uses the active query. 


DISPLAY=YES | NO 
This option specifies whether the result is to be displayed at your display station. Display cannot 
be YES if you run queries in batch mode (see 


If you omit the DISPLAY option, it defaults to YES if you run queries interactively, or to NO if you 
run queries in batch mode. 


FORM=*SYSDFT | * | name 
This option specifies the report form to be applied. If you omit the FORM option, Query Manager 
generates a default report form (*SYSDFT). 


The name can be specified as: 


*SYSDFT 
Uses a system generated default report form. See 
for a description of the *“SYSDFT report form. 


* Uses the active form. 


name_ The name of the report form to be used, and the name of the library where it resides. If 
you do not specify a library name, the default library for query objects specified in your 
Query Manager profile is searched for the named form when the statement is run. You can 
specify the name of the report form and library in one of the following ways: 


¢ library.formname Use this format if your Query Manager profile specifies that you use 
the SQL naming convention. 


¢ library/formname Use this format if your Query Manager profile specifies that you use 
the system naming convention. Specify *LIBL to search your library list. 


Examples of RUN statement in Query Manager 
RUN PROC WEEKREPT 


RUN QUERY * (FORM=* 
RUN QUERY SMITH.STAFF (DISPLAY=NO 


RUN QUERY SMITH.STAFF (FORM=SMITH.SAL_REPT 


SAVE DATA AS in Query Manager 


You use the SAVE DATAAS statement to save data in a table in the database. The saved table object is 
named according to the name you specify with the statement. If data is saved and a table or view is being 
replaced, the data needs to be compatible with the existing definition. Compatible data has matching data 
types, lengths, and null attributes. The number of columns in the data needs to match the target, and the 
columns need to have compatible data types and null characteristics. If two objects are incompatible, the 
statement is rejected. 


If the name you are saving data to is a view in the database, the table on which the view is defined is 
changed. 
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SAVE DATA AS 


Syntax of SAVE DATA AS in Query Manager 
A syntax diagram of the SAVE DATA AS statement follows: 


p>e—SAVE DATA AS—tablename L 
( Options = 


>< 


Options: 


| | 
CONF IRM—= YES | | --REPLACE | COMMENT—=—’ text’ 
ACT ION—= APPEND— 


DATA This part of the statement refers to the active data produced by the most recent interactively run 
SQL SELECT statement query or prompted query. 


tablename 
The name of the table or view in which the data is stored in the database, and the name of the 
library where it resides. You can specify the name of the table and library (or collection) in one of 
the following ways: 


* collection.tablename Use this format if your Query Manager profile specifies that you use the 
SQL naming convention. If you do not specify a collection name, the default library for query 
objects specified in your Query Manager profile is searched for the named table when the 
statement is run. 


* library/filename Use this format if your Query Manager profile specifies that you use the 
system naming convention. If you do not specify a library name, your library list (*LIBL) is 
searched for the named file when the statement is run. 


CONFIRM=YES | NO 
This option provides for a check before performing your SAVE DATA AS request. If a table or view 
with the specified name already exists and is about to be replaced, and the option is set to YES, 
you are prompted to confirm that the existing table or view is to be replaced. If the option is set to 
NO, replacement occurs without confirmation. The default is YES, but you can change the default 
value in your Query Manager profile (see 


ACTION=REPLACE | APPEND 
REPLACE causes an existing table or view to be replaced. APPEND causes the data to be added 
to the end of an existing table or view. The default is REPLACE. 


COMMENT= ‘tex?’ 
Use this option to supply a comment when saving data as a table. If the comment contains 
multiple words or imbedded blanks, you need to enclose it in single quotation marks. Quotation 
marks within the comment need to be entered as two adjacent single quotation marks: 


COMMENT='Don't ERASE this data without telling Simon!' 


Examples of SAVE DATA AS statement in Query Manager 


SAVE DATA AS EMP12 


SAVE DATA AS EMP12 (COMMENT='CLASSIC TWO TABLE JOIN' 


SAVE FORM AS in Query Manager 


Use the SAVE FORM AS statement to save the active form. If there is no active form, an error message is 
displayed. 
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SAVE FORM AS 


Syntax of SAVE FORM AS in Query Manager 
A syntax diagram of the SAVE FORM AS statement follows: 


>>—SAVE FORM AS—name L 
( Options = 


>< 


Options.: 
| 


CONF IRM—= ag | COMMENT—=—’ text’ 
NO 


name The name of the report form to be saved, and the name of the library where it resides. If you do 
not specify a library name, the default library for query objects specified in your Query Manager 
profile is searched for the named form when the statement is run. You can specify the name of the 
report form and library in one of the following ways. 


¢ library.formname Use this format if your Query Manager profile specifies that you use the SQL 
naming convention. 


¢ library/formname Use this format if your Query Manager profile specifies that you use the 
system naming convention. Specify *LIBL to search your library list. 


CONFIRM=YES | NO 
This option provides for a check before performing your SAVE request. If a report form with the 
specified name already exists in the library and the option is set to YES, you are prompted to 
confirm that the existing report form is to be replaced. If the option is set to NO, replacement 
occurs without confirmation. 


The default value is YES, but you can change the default in your Query Manager profile (see 


COMMENT= ‘tex?’ 
This option allows you to apply a description to the report form. The description is shown in the 
Work with Query Manager Report Forms display. 


Because text usually consists of multiple words and blank spaces, you need to enclose it in single 
quotation marks. If you want to include a single quotation mark or an apostrophe in the text, you 
need to enter it as two adjacent single quotation marks. For example: 


COMMENT='Anne's monthly sales report form' 


The maximum length of text is for the comment is 50 characters, excluding the enclosing quotation 
marks. 


Examples of SAVE FORM statement in Query Manager 


SAVE FORM AS SAL_REPT 


SAVE FORM AS SAL_REPT (CONFIRM=NO COMMENT='Monthly sales' 


SAVE QUERY AS in Query Manager 


Use the SAVE QUERY AS statement to save the active query. If there is no active query, an error 
message is displayed. 
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SAVE QUERY AS 


Syntax of SAVE QUERY AS in Query Manager 
A syntax diagram of the SAVE QUERY AS statement follows: 


p>>—SAVE QUERY AS—name L 
( Options = 


>< 


Options: 


CONF IRM—= ae COMMENT—=—’ text’ 


name_ The name of the query to be saved, and the name of the library where it resides. If you do not 
specify a library name, the default library for query objects specified in your Query Manager profile 
is searched for the object when the statement is run. You can specify the name of the query and 
library in one of the following ways: 


¢ library.queryname Use this format if your Query Manager profile specifies that you use the 
SQL naming convention. 


¢ library/queryname Use this format if your Query Manager profile specifies that you use the 
system naming convention. Specify *LIBL to search your library list. 


CONFIRM=YES | NO 
This option provides for a check before performing your SAVE request. If a query with the 
specified name already exists in the library and the option is set to YES, you are prompted to 
confirm that the existing query is to be replaced. If the option is set to NO, replacement occurs 
without confirmation. 


The default value is YES, but you can change the default in your Query Manager profile (see 


COMMENT= ‘tex?’ 
This option allows you to apply a description to the query. The description is shown in the Work 
with Query Manager Queries display. 


Because text usually consists of multiple words and blank spaces, you need to enclose it in single 
quotation marks. If you want to include a single quotation mark or an apostrophe in the text, you 
need to enter it as two adjacent single quotation marks. For example: 


COMMENT='Mario's January sales' 


The maximum length of text is 50 characters, excluding the enclosing quotation marks. 
Examples of SAVE QUERY AS statement in Query Manager 
SAVE QUERY AS SMITH.X41 


SAVE QUERY AS X41 (CONFIRM=NO COMMENT='January sales' 


SET CONNECTION in Query Manager 


Use the SET CONNECTION statement to change the state of a connection from dormant to current. The 
SET CONNECTION statement is only useful when running under DUW connection management. 


A dormant state means that a connection is temporarily suspended. While a connection is dormant, no 
SQL statements may use the connection, except for commits and rollbacks. 


While a connection is current, any SQL statement may use the connection. Only one connection may be in 
the current state for each activation group. 
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SET CONNECTION 


If a SET CONNECTION command is successful: 
¢ The previous current connection, if any, is placed in the dormant state. 
* The identified application server is placed in the current state. 


If the SET CONNECTION command is unsuccessful, the connection state of the default activation group 
and the states of its connections are unchanged. 


A list of relational databases connected to the default activation group and their connection information can 
be obtained by prompting on the SET CONNECTION statement. 


The SET CONNECTION statement is not allowed in Query Manager queries. 


Syntax of SET CONNECTION in Query Manager 


A syntax diagram of the SET CONNECTION statement follows: 
>>—SET CONNECT ION—rdbname >< 


rdbname The name of the relational database (rdb) that is currently being accessed. An rdbname 
can be up to 18 characters in length and can only consist of uppercase letters, numerics, 
or an underscore. The first character must be an uppercase letter. 


Examples of the SET CONNECTION statement in Query Manager 


The following statements send SQL statements to RDB1 after the first command, to RDB2 after the 
second, and then to RDB1 again after the third command. The first CONNECT command creates the 
RDB1 connection and places it in the current state. 


CONNECT TO RDB1 
SQL statements 


The next CONNECT command creates the RDB2 connection, places it in the current state, and places 
RDB1 in the dormant state. 


CONNECT TO RDB2 
SQL statements 


The next SET CONNECTION command returns RDB1 to the current state and places RDB2 in the 
dormant state. 


SET CONNECTION RDB1 


SQL statements 
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Appendix C. Implications of allowed SQL statements in Query 
Manager 


When you allow and restrict SQL statements for users through their Query Manager profiles, you 
determine which SQL statements ney can use Cun creating, cheney, and running SQL queries through 
Query Manager (see 
appendix describes how and when fie =lawences and re aelehe apply, and tells you how to cause the 
restrictions to apply outside Query Manager. 


Query Manager 
When you grant and restrict users’ authorities for SQL statements, you limit the statements they 
can use when creating, changing, and running SQL queries through Query Manager. These 
limitations do not exist outside Query Manager. 


Prompted Queries 
Allowed and restricted SQL statements have no effect on promptedqueries. Users who have a 
“Default query creation mode” of prompted, or who can change their query creation modes, can 
create, change, and run prompted queries. They do not need authority to use the SELECT 
statement. 


Working with SQL Queries 
Allowed and restricted SQL statements affect SQL queries only when users create, change, or run 
them. Users can still copy, rename, display, and print SQL queries containing all SQL statements. 


Running Queries in Batch Mode 
The authorities and restrictions apply to all Query Manager options and functions that result in 
SQL queries being run in batch mode. This includes issuing the RUN QUERY statement on the 
Query Manager statement line, or choosing to use batch mode from the Run Query display. 


When the Authorities Apply 

The authorities and restrictions apply to all SQL queries created and run interactively in Query 

Manager. The authorities apply under the following circumstances: 

* When any Query Manager option or function is performed that results in creating or running an 
SQL query. 

¢ When the RUN QUERY, IMPORT QUERY, or SAVE QUERY Query Manager statements are 
issued on the Query Manager statement line. 

¢ When a Query Management CL command that creates or runs an SQL query is issued: for 
example, the STRQMQRY, CRTQMQRY, and STRQMPRC commands. The SQL restrictions 
apply if Query Manager is in the program stack when the CL command is issued. 


When the Authorities Do Not Apply 
The authorities and restrictions do not apply under the following circumstances: 
¢ When users create or run queries using the Query Management Common Programming 
Interface (CPI). See Query Management Programming. 
¢ When users run the STRQMQRY, CRTQMQRY, or STRQMPRC CL commands and Query 
Manager is not on the program stack. 


¢ When users who are restricted to batch mode issue a RUN PROC Query Manager statement 
on the Query Manager statement line. 


Restricting Users outside DB2 UDB for iSeries Query Manager 
Security administrators can use the OS/400 object level authority functions to restrict users from 
running or creating queries outside Query Manager, although this does not allow the statement 
type checking available through Query Manager. For example: 
¢ Remove authority to the CRTQMQRY CL command, to force users to create all queries through 
Query Manager or the Query Management CPI. 
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* Restrict users from creating programs that use the Query Management CPI. You can do this in 
one of two ways: 

1. Remove authority to the Query Management CPI include files (see Query Management 
Programming). Then, unless users code their own include members, they cannot create 
programs that use the Query Management CPI. 

2. Remove authority to the C/400®, COBOL/400®, and RPG/400® languages. 

¢ Remove authority to the STRQMPRC CL command, to force users to create and run all queries 
through Query Manager or the Query Management CPI. Note that users who do not have 
authority to the STRQMPRC command cannot run procedures in batch mode using Query 

Manager. 

¢ Remove authority to the STRQMQRY CL command, to force users to run all queries through 

Query Manager or the Query Management CPI. Note that users who do not have authority to 

the STRQMQRY command cannot run queries in batch mode using Query Manager. 
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Appendix D. Example: Sort sequence in Query Manager 


This appendix shows how to use the support for sort and comparison testing in multiple language 
environments. 


These example queries and reports are run against the information shown in Table 17] Notice that the 
values in the JOB column are in different cases. For example, the job code for manager is entered as Mgr, 
MGR, and mgr. A sort sequence table can help you manage this situation. 


Table 17. Employee Table 


ID NAME DEPT JOB YEARS SALARY COMM 
10 Sanders 20 Mor 7 18357.50 0 
20 Pernal 20 Sales 8 18171.25 612.45 
30 Marenghi 38 Mgr 5 17506.75 0 
40 OBrien 38 Sales 6 18006.00 846.55 
50 Hanes 15 Mgr 10 20659.80 0 
60 Quigley 38 Sales 00 16808.30 650.25 
70 Rothman 15 Sales 7 16502.83 1152.00 
80 James 20 Clerk 0 13504.60 128.20 
90 Koonitz 42 sales 6 18001.75 1386.70 
100 Plotz 42 mgr 6 18352.80 0 


Example: Sort sequence usages in Query Manager 


The Query Manager uses the sort sequence table for several operations: 
* Sorting 

* Grouping 

° Joining 

* Selecting records 

¢ Determining minimum and maximum values 

¢ Determining report breaks that involve SBCS character data 


In the following examples, you see the query and resulting report using: 
¢ The binary character code sort sequence (*HEX) 

¢ Ashared collating weight sort sequence (*“LANGIDSHR) 

* A unique collating weight sort sequence (*LANGIDUNQ) 


Example: Sorting in Query Manager 
The following SQL statement causes the report to be sorted using the values in the JOB column. 
SELECT * FROM EMPLOYEE ORDER BY JOB 


Figure 170 on page 268 shows how the information in [able 17 sorts using the *HEX sort sequence. The 


rows are sorted by the value in the JOB column without recognizing that the values are uppercase and 
lowercase variations of the same words. MGR and mgr are treated as different values. Also, with the *HEX 
sort sequence, sales sorts before Sales and SALES. 
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ID NAME DEPT JOB YEARS SALARY COMM 


000001 100 = Plotz 42 mgr 7 18,352.80 00 
000002 90 ~=Koonitz 42 sales 6 18,001.75 1,386.70 
000003 80 James 20 ~=Clerk 0 13,504.60 128.20 
000004 10 Sanders 20 Mgr 7 18,357.50 00 
000005 50 Hanes 15 Mgr 10 20,659.80 00 
000006 30 Marenghi 38 MGR 5 17,506.75 00 
000007 20 = Pernal 20 ~=Sales 8 18,171.25 612.45 
000008 40 OBrien 38 =Sales 6 18,006.00 846.55 
000009 70 Rothman 15 Sales 7 16,502.83 1,152.00 
000010 60 Quigley 38 SALES ) 16,808.30 650.25 


KeKKKK kee ee END OF DATA ***** 


Figure 170. SRTSEQ=*HEX. Example report that shows sorting with no sort sequence. 


Figure 171] shows how the information shown in [able 17 on page 267 sorts using a shared sort sequence. 


The lowercase letters are treated the same as their uppercase version. Thus, mgr, Mgr,and MGR are 
grouped together. 


ID NAME DEPT JOB YEARS SALARY COMM 
000001 80 James 20 ~=Clerk 0 13,504.60 128.20 
000002 10 Sanders 20 Mgr 7 18,357.50 00 
000003 30 Marenghi 38 MGR 5 17,506.75 00 
000004 50 Hanes 15 Mgr 10 20,659.80 00 
000005 100 = Plotz 42 mgr 7 18,352.80 00 
000006 20 = Pernal 20 ~=Sales 8 18,171.25 612.45 
000007 40 OBrien 38 =Sales 6 18,006.00 846.55 
000008 60 Quigley 38 SALES 0 16,808.30 650.25 
000009 70 Rothman 15 Sales 7 16,502.83 1,152.00 
000010 90 ~=Koonitz 42 sales 6 18,001.75 1,386.70 


KRKKKK Ok eK eK ee END OF DATA ***x** 


Figure 171. SRTSEQ=*LANGIDSHR, LANGID=ENU. Example report that shows sorting with a shared sort sequence. 


Figure 172] shows how the information in [Table 17 on page 267 sorts using a unique sort sequence. The 


lowercase and uppercase letters are treated as unique, but they have collating weights that cause them to 
sort adjacently. The lowercase letter sorts before the uppercase. This is the sorting that you see in national 
language dictionaries. 


ID NAME DEPT JOB YEARS SALARY COMM 
000001 80 James 20 ~=Clerk 0 13,504.60 128.20 
000002 100 = Plotz 42 mgr 7 18,352.80 00 
000003 10 Sanders 20 Mgr 7 18,357.50 00 
000004 50 Hanes 15 Mgr 10 20,659.80 00 
000005 30 Marenghi 38 MGR 5 17,506.75 00 
000006 90 ~Koonitz 42 sales 6 18,001.75 1,386.70 
000007 20 ~=— Pernal 20 ~=Sales 8 18,171.25 612.45 
000008 40 OBrien 38 =Sales 6 18,006.00 846.55 
000009 70 Rothman 15 Sales 7 16,502.83 1,152.00 
000010 60 Quigley 38 SALES 0 16,808.30 650.25 


KeKKKK Ok eK eK ee END OF DATA **x*x** 


Figure 172. SRTSEQ=*LANGIDUNQ, LANGID=ENU. Example report that shows sorting with a unique sort sequence. 


Example: Record selection in Query Manager 
The following SQL statement selects only the records with the value MGR in the JOB column. 
SELECT * FROM EMPLOYEE WHERE JOB='MGR' 
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Figure 173] shows record selection with the *HEX sort sequence. The rows that exactly match the record 
selection criteria are selected. Mgr and mgr are not selected because they are not treated the same as 
MGR. 


ID NAME DEPT JOB YEARS SALARY COMM 


000001 30  Marenghi 38 MGR 5 17,506.75 00 
KRRKKK Ok eK eK ee END OF DATA *«**x** 
Figure 173. SRTSEQ=*HEX. Example report that shows record selection with no sort sequence. 


igure 174] shows record selection with a shared sort sequence. The rows with Mgr, MGR, and mgr are all 
selected because the uppercase and lowercase versions of the letters are treated the same way. 


ID NAME DEPT JOB YEARS SALARY COMM 
000001 10 Sanders 20 Mgr 7 18,357.50 00 
900002 30  Marenghi 38 MGR 5 17,506.75 00 
000003 50 Hanes 15 Mgr 10 20,659.80 00 
000004 100 = Plotz 42 mgr 7 18,352.80 00 


KeEKKK Ok eK eK ee END OF DATA **x*x** 


Figure 174. SRTSEQ=*LANGIDSHR, LANGID=ENU. Example report that shows record selection with a shared sort 
sequence. 


Figure 175] shows record selection with a unique sort sequence. The lowercase and uppercase letters are 
treated as unique even though they are adjacent in the collating sequence. Mgr and mgr are not selected 
because they are not treated the same as MGR. 


ID NAME DEPT JOB YEARS SALARY COMM 


000001 30  Marenghi 38 MGR 5 17,506.75 -00 
KeEKKK Ok eK eK ee END OF DATA **x*x** 


Figure 175. SRTSEQ=*LANGIDUNQ, LANGID=ENU. Example report that shows record selection with a unique sort 
sequence. 


Example: Report breaks in Query Manager 


The following SQL statement sorts the values in the JOB column. The report uses a BREAK1 on the JOB 
column and a SUM on the SALARY column. 


SELECT * FROM EMPLOYEE ORDER BY JOB 


Figure 176 on page 270 shows report breaks with a *HEX sort sequence. The rows are grouped by the 
value changes in the JOB column. The uppercase and lowercase versions of the letters are treated 


differently. MGR and mgr are not treated the same as the mixed case Mgr and so are not grouped into the 
same break level. 
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ID NAME DEPT JOB YEARS SALARY COMM 


000001 100 = Plotz 42 mgr 7 18,352.80 .00 
0000020 ee nen 

000003 * 18,352.80 

000004 

000005 90 ~=Koonitz 42 sales 6 18,001.75 1,386.70 
000006 nee 

000007 * 18,001.75 

000008 

000009 80 James 20 ~=Clerk 0 13,504.60 128.20 
000010 eee nen 

000011 * 13,504.60 

000012 

000013 10 Sanders 20 Mgr 7 18,357.50 .00 
000014 50 Hanes 15 10 20,659.80 .00 
000015 eee nen 

000016 * 39,017.30 

000017 

000018 30 Marenghi 38 MGR 5 17,506.75 .00 
000019 nen 

000020 * 17,506.75 

000021 

000022 20 ~=— Pernal 20 ~=Sales 8 18,171.25 612.45 
000023 40 OBrien 38 6 18,006.00 846.55 
000024 70 Rothman 15 7 16,502.83 1,152.00 
000025 nen 

000026 * 52,680.08 

000027 

000028 60 Quigley 38 SALES 0 16,808.30 650.25 
000029 ene 

000030 * 16,808.30 

000031 


KRKKKK Ok eK eee END OF DATA ** x x** 


Figure 176. SRTSEQ=*HEX. Example report that shows report breaks with no sort sequence. 


Figure 177 on page 271] shows report breaks with a unique sort sequence. The rows are grouped by the 
value in the JOB column, and lowercase letters are treated the same as uppercase letters. The values 


mgr, Mgr, and MGR are grouped together at the same break level. 
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ID NAME DEPT JOB YEARS SALARY COMM 


000001 80 James 20 ~=Clerk 0 13,504.60 128.20 
0000020 ene 

000003 * 13,504.60 

000004 

000005 10 Sanders 20 Mgr 7 18,357.50 .00 
000006 30 Marenghi 38 5 17,506.75 .00 
000007 50 Hanes 15 10 20,659.80 .00 
000008 100 = Plotz 42 7 18,352.80 .00 
000009 eee nen 

000010 * 74,876.85 

000011 

000012 20 ~=— Pernal 20 ~=Sales 8 18,171.25 612.45 
000013 40 OBrien 38 6 18,006.00 846.55 
000014 60 Quigley 38 0 16,808.30 650.25 
000015 70 Rothman 15 7 16,502.83 1,152.00 
000016 90 ~=©Koonitz 42 6 18,001.75 1,386.70 
OOOOLF ene 

000018 * 87,490.13 

000019 


KRRKKK Ok eK eK ee UO END OF DATA *«**x** 


Figure 177. SRTSEQ=*LANGIDSHR, LANGID=ENU. Example report that shows report breaks with a shared sort 
sequence. 


Figure 178 on page 274 shows report breaks with a unique sort sequence. The rows are sorted by the 
value in the JOB column. Lowercase and uppercase letters are treated as unique, but they have a weight 


that causes them to sort adjacently. The lowercase letter sorts first. When the rows are grouped into break 
levels, only the values that are exactly the same are grouped together. 
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ID NAME DEPT JOB YEARS SALARY COMM 


000001 80 James 20 =Clerk 0 13,504.60 128.20 
0000020 en 

000003 * 13,504.60 

000004 

000005 100 = Plotz 42 mgr 7 18,352.80 .00 
000006 ene 

000007 * 18,352.80 

000008 

000009 10 Sanders 20 Mgr 7 18,357.50 .00 
000010 50 Hanes 15 Mgr 10 20,659.80 .00 
OOOOL, ee 

000012 * 39,017.30 

000013 

000014 30 Marenghi 38 MGR 5 17,506.75 .00 
000015 ee nen 

000016 * 17,506.75 

000017 

000018 90 ~=Koonitz 42 sales 6 18,001.75 1,386.70 
000019 ene 

000020 * 18,001.75 

000021 

000022 20 ~=Pernal 20 = Sales 8 18,171.25 612.45 
000023 40 OBrien 38 = Sales 6 18,006.00 846.55 
000024 70 ~=Rothman 15 Sales 7 16,502.83 1,152.00 
000025 nen 

000026 * 52,680.13 

000027 

000028 60 Quigley 38 SALES 0 16,808.30 650.25 
000029 nen 

000030 * 16,808.30 

000031 


KeKKKK Ok eK eK ee END OF DATA **x*x** 


Figure 178. SRTSEQ=*LANGIDUNQ, LANGID=ENU. Example report that shows report breaks with a unique sort 
sequence. 


Example: Grouping in Query Manager 
The following SQL statement groups the summary data using the values in the JOB column. 
SELECT JOB, SUM(SALARY) FROM EMPLOYEE GROUP BY JOB ORDER BY JOB 


Figure 179] shows a query grouping with a *HEX sort sequence. For report breaks, the rows are grouped 
by the value in the JOB column. The uppercase and lowercase versions of the same letter are treated 
differently. 


JOB SUM ( SALARY ) 
000001 mgr 18,352.80 
000002 = sales 18,001.75 
000003 Clerk 13,504.60 
000004 Mgr 39,017.30 
000005 MGR 17,506.75 
000006 =Sales 52,680.08 
000007 SALES 16,808.30 


KRKKKK Ok eK eK ee UO END OF DATA *«*x*x** 


Figure 179. SRTSEQ=*HEX. Example report that shows grouping with no sort sequence. 


272 DB2 UDB for iSeries Query Manager Use V5R2 


Figure 180] shows query grouping with a shared sort sequence. For report breaks, the rows are grouped 
by the value in the JOB column, and the lowercase version of a letter is treated the same as the 
uppercase version. Notice that mgr, Mgr, and MGR are grouped together. 


JOB SUM ( SALARY ) 
000001 Clerk 13,504.60 
900002 Mgr 74,876.85 
000003 Sales 87,490.13 


KeEKKK Ok eK eK eK *eOUO END OF DATA **x*x** 


Figure 180. SRTSEQ=*LANGIDSHR, LANGID=ENU. Example report that shows grouping with a shared sort 
sequence. 


Figure 181] shows a query grouping with a unique sort sequence. The rows are sorted by the value in the 
JOB column. Lowercase and uppercase letters are treated as unique, but they have weights that cause 
adjacent sorting. The lowercase letter sorts first. When the rows are grouped into break levels, only the 
values that are exactly the same are grouped together. 


JOB SUM ( SALARY ) 
000001 Clerk 13,504.60 
000002 mgr 18,352.80 
000003 Mgr 39,017.30 
000004 MGR 17,506.75 
000005 ~=sales 18,001.75 
000006 =§ Sales 52,680.13 
000006 SALES 16,808.30 


KeRKKK Ok eK eK ee END OF DATA *«*x*x** 


Figure 181. SRTSEQ=*LANGIDUNQ, LANGID=ENU. Example report that shows grouping with a unique sort 
sequence. 
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Appendix E. Notices 


This information was developed for products and services offered in the U.S.A. IBM may not offer the 
products, services, or features discussed in this document in other countries. Consult your local IBM 
representative for information on the products and services currently available in your area. Any reference 
to an IBM product, program, or service is not intended to state or imply that only that IBM product, 
program, or service may be used. Any functionally equivalent product, program, or service that does not 
infringe any IBM intellectual property right may be used instead. However, it is the user’s responsibility to 
evaluate and verify the operation of any non-IBM product, program, or service. 


IBM may have patents or pending patent applications covering subject matter described in this document. 
The furnishing of this document does not give you any license to these patents. You can send license 
inquiries, in writing, to: 


IBM Director of Licensing 
IBM Corporation 

500 Columbus Avenue 
Thornwood, NY 10594 
U.S.A. 


For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property 
Department in your country or send inquiries, in writing, to: 


IBM World Trade Asia Corporation 
Licensing 

2-31 Roppongi 3-chome, Minato-ku 
Tokyo 106-0032, Japan 


The following paragraph does not apply to the United Kingdom or any other country where such 
provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION 
PROVIDES THIS PUBLICATION “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR 
IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, 
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer 
of express or implied warranties in certain transactions, therefore, this statement may not apply to you. 


This information could include technical inaccuracies or typographical errors. Changes are periodically 
made to the information herein; these changes will be incorporated in new editions of the publication. IBM 
may make improvements and/or changes in the product(s) and/or the program(s) described in this 
publication at any time without notice. 


Any references in this information to non-IBM Web sites are provided for convenience only and do not in 
any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of 
the materials for this IBM product and use of those Web sites is at your own risk. 


Licensees of this program who wish to have information about it for the purpose of enabling: (i) the 
exchange of information between independently created programs and other programs (including this one) 
and (ii) the mutual use of the information which has been exchanged, should contact: 


IBM Corporation 

Software Interoperability Coordinator 
3605 Highway 52 N 

Rochester, MN 55901-7829 

U.S.A. 


Such information may be available, subject to appropriate terms and conditions, including in some cases, 
payment of a fee. 


© Copyright IBM Corp. 1998, 2002 275 


The licensed program described in this information and all licensed material available for it are provided by 
IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement, or any 
equivalent agreement between us. 


Any performance data contained herein was determined in a controlled environment. Therefore, the results 
obtained in other operating environments may vary significantly. Some measurements may have been 
made on development-level systems and there is no guarantee that these measurements will be the same 
on generally available systems. Furthermore, some measurements may have been estimated through 
extrapolation. Actual results may vary. Users of this document should verify the applicable data for their 
specific environment. 


Information concerning non-IBM products was obtained from the suppliers of those products, their 
published announcements or other publicly available sources. IBM has not tested those products and 
cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. 
Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. 


All statements regarding IBM’s future direction or intent are subject to change or withdrawal without notice, 
and represent goals and objectives only. 


All IBM prices shown are IBM’s suggested retail prices, are current and are subject to change without 
notice. Dealer prices may vary. 


This information is for planning purposes only. The information herein is subject to change before the 
products described become available. 


This information contains examples of data and reports used in daily business operations. To illustrate 
them as completely as possible, the examples include the names of individuals, companies, brands, and 
products. All of these names are fictitious and any similarity to the names and addresses used by an 
actual business enterprise is entirely coincidental. 


COPYRIGHT LICENSE: 


This information contains sample application programs in source language, which illustrate programming 
techniques on various operating platforms. You may copy, modify, and distribute these sample programs in 
any form without payment to IBM, for the purposes of developing, using, marketing or distributing 
application programs conforming to the application programming interface for the operating platform for 
which the sample programs are written. These examples have not been thoroughly tested under all 
conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these 
programs. You may copy, modify, and distribute these sample programs in any form without payment to 
IBM for the purposes of developing, using, marketing, or distributing application programs conforming to 
IBM’s application programming interfaces. 


Each copy or any portion of these sample programs or any derivative work, must include a copyright 
notice as follows: 


© (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. © 
Copyright IBM Corp. _enter the year or years_. All rights reserved. 


If you are viewing this information softcopy, the photographs and color illustrations may not appear. 


Trademarks 


The following terms are trademarks of the IBM Corporation in the United States or other countries or both: 
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C/400 

DB2 

Distributed Relational Database Architecture 
DRDA 

e (logo) IBM 

IBM 

iSeries 

MVS 

Operating System/400 
OS/400 

QMF 

Redbooks 

RPG/400 

System/36 

SQL/DS 


Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun 
Microsystems, Inc. in the United States, other countries, or both. 


Other company, product, and service names may be trademarks or service marks of others. 
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Special Characters B 
- (hyphen) to denote null value 162 base keys (F2) function key 23 
-- double hyphen in queries 73 basic access level 35, 38, 45, 55, 113 
(DUW), distributed unit of work 181 batch mode 38, 146 
* to indicate active form or active query 147 BOTTOM blank lines before 128, 130 
*ALL object creation authority 37 BOTTOM edit command 76 
*CHANGE object creation authority 37 Bottom indicator 17, 21 
*CURLIB library 3 brackets [] 163, 196 
“EXCLUDE authority for a library or collection 153 BREAK column usage 119 
“EXCLUDE object creation authority 37 breaks 
“JOB printer 42 definition 6 
*LIBCRTAUT object creation authority 37 example 269 
*LIBL library 3 headings and footings 130, 235 
*NONE to specify a blank column heading in a report ORDER BY clause 6, 119 
form 119 report 269 
*“OBJMGMT rights 17, 33, 48 sequence 119 
*QMFORM 1 specifying 119, 230 
*QMQRY 1 summary data 119, 130 
*READ rights 17, 33, 48 BT (between) test operator 99 
*SAA naming convention 40 
*“SECADM authority 17, 33, 48 
*SYS naming convention 40 C 
*SYSDFT report form 5, 82, 113, 147, 226 cancel (F12) function key 14, 23 
*USE object creation authority 37 change commitment control level 43 
& ampersand to denote variable 70 CHANGE edit command 76, 78 
&col variable 125, 130, 236, 237 change query creation mode (F19) function key 56, 
&DATE variable 128, 232 67, 68 
&n variable 128 CHARACTER data type 119, 160, 162, 164 
&PAGE variable 128, 233 check syntax (F15) function key 73, 78 
&TIME variable 128 CNT (COUNT) summary function 102 
collections 
*CURLIB collection 3 
A *EXCLUDE authority 153 
activation group, default 182 *LIBL collection 3 
active data 8, 38, 82, 115, 117, 147, 149, 225 changing the collection 20, 154, 156 
active form 8, 106 creating a collection 41 
active query 7, 69, 118 default collection for QM tables 41, 154, 156 
add data (f19) function key 171 definition 3 
add data (F19) function key 157, 163, 196 difference between collection and library 3 
all access level 34, 38, 46, 67 column names displayed, system 45 
all commitment control level 43 columns 2, 157, 159 
allow access to QM tables option 44 command window 28, 40 
allow change query creation mode 44, 68 comments in queries 73 
allow change run query mode 38, 146 COMMIT statement 52, 55, 154, 187, 247 
allow interactive sample run 39 commitment control level 
allowed SQL statements 265 all 43 
alternate keys (F2) function key 23 change 43 
ampersand (&) to denote variable 70 cursor stability 43 
AND, OR, (, ), for Query Manager tables 166, 204 repeatable read 43 
AND/OR connector for prompted query 95, 97 CONCAT function 92 
arithmetic operators for prompted query 90 confirm run query 149 
asterisk (*) to indicate active query or active form 147 confirmation messages in QM 40 
authorization list 37 CONNECT statement 2, 40, 52, 67, 73, 82, 84, 154, 
AVERAGE (AVG) column usage 119 248 
AVG (AVERAGE) summary function 102 examples 249 
connecting 


to a relational database 182 
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connection management 181 

connection method, relational database 41 
considerations, SET TRANSACTION 187 
constants in queries 69 

control language (CL) 70 

Control prompt 148, 175 

converting a prompted query to SQL 110 
copy line (F10) function key 23, 202 
COUNT column usage 119 

cursor (F10) function key 78 

cursor stability commitment control level 43 
customized run-time prompts 70 


D 


data entry guidelines 163 
data types 
CHARACTER 119, 160, 162, 164 
DATE 119, 160 
DBCS characters 4, 160, 164, 166 
DECIMAL 160, 162 
decimal places 157 
default values 162 
difference between CHARACTER and 
VARCHAR 162 
difference between DECIMAL and NUMERIC 162 
DOUBLE 160 
FLOAT 160 
for report forms 119 
for tables 157, 160 
GRAPHIC 119, 160, 164 
INTEGER 160 
length 157 
list 160 
null values 90, 162 
NUMERIC 160, 162 
OPEN 164 
REAL 160 
setlength 157, 160 
SMALLINT 160 
TIME 119, 160 
TIMESTAMP 119, 160 
VARCHAR 160, 162, 164 
VARGRAPHIC 160, 164 
database 
*SYS naming considerations 40 
commitment control 43, 55 
definition 2 
remote connection 40, 52, 154, 248 
database connection method 41 
DATE data type 160 
format considerations 109, 149 
separator 119 
date/time format considerations 109, 149 
DB2 UDB for iSeries 4 
DB2 UDB for iSeries Query Manager 10 
denying access 48 
description 1 
exiting 14 
general concepts 2 
starting 13 
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DB2 UDB for iSeries Query Manager (continued) 
using displays 17 
DB2 UDB for iSeries SQL 10, 55 
DBCS characters 4, 160, 164, 166 
DECIMAL data type 160, 162 
default activation group 182 
defaults 
default collection for QM tables 41, 156 
default form 8 
default library for QM tables 41, 156 
default library for Query Manager objects 37 
default object creation authority 37 
default printer 42 
default QM profile 17, 36 
default query 7 
default query creation mode 43 
define expression (F10) function key 102 
define prompted query display 84 
defining expressions in a prompted query 90 
delete data row (F23) function key 169, 210 
delete line (F14) function key 23, 202 
deleting prompted query comparison tests 95 
denied access to tables 14, 16, 44, 153 
DIGITS function 92 
DISCONNECT statement 250 
DISPLAY 251 
report 251 
sample report 251 
display additional details (F10) function key 17 
display column names (F19) function key 84 
display column/system column names (F19) function 
key 23 
display connection status 23 
display description (F11) function key 23, 88 
display entire name (F20) function key 23 
displaying 169 
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display form only (F11) function key 23, 136 
display profile only (F11) function key 23 
display query (F13) function key 23, 59, 137 
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display report 175 
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display run options 39, 144 
display sample (F5) function key 115, 117, 137 
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DISPLAY statement 251 
display system column names (F19) function key 84 
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displaying query output 148 
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DOUBLE data type 160 
DRAW statement 73, 82, 252 
DRDA 
distributed relational database architecture 181 


duplicate column (F10) function key 95 
duplicating columns in a prompted query 95 
DUW 

distributed unit of 181 
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edit column formatting 119, 229 
edit commands 
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change 76, 78 

find 76, 78 

left 76 

right 76 

top 76 
edit form (F13) function key 23, 82, 118, 242 
edit heading (F11) function key 119, 229 
edit query (F13) function key 23, 82, 118, 242 
edit usage (F11) function key 119, 229 
entering information 18 
entire name window, display 26 
EQ, =, join condition 87 
ERASE statement 252 
error messages 27 
examples 

CONNECT statement 

DUW connection management 249 
RUW connection management 249 

SET CONNECTION statement 264 

sort sequence 267 
exit (F3) function key 14, 23 
exit display 107, 115, 225, 244 
exiting DB2 UDB for iSeries Query Manager 14 
exiting the Display Report display 149 
EXPORT statement 253 
extended help (F2) function key 22 
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file to use for output 42, 147 
final summary data omitted 9, 39, 146 
find data (F16) function key 165, 169, 170 
FIND edit command 76, 78 
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FO5 Display report 238 
FO5 Ref 23 
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F11 (Display description/Display name only) 23, 58, 
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F16 (Repeat find) 76, 78 
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global variables 70 

GRAPHIC data type 119, 160, 164 
GROUP BY clause 102 

group, default activation 182 
grouping 272 

GT, >, join condition 87 
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context-sensitive 17, 22 
extended 22 
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help (F1) function key 17, 22 
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insert line (F6) function key 23 

INTEGER data type 160 N 

interactive mode 38, 146 
maximum rows allowed 9, 39 
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naming conventions 29 
CONNECT statement considerations 40 
J SAA 40 
SYS (system) 40 
NE, <>, join condition 87 
next data row (F15) function key 165, 169, 170, 210 
NL (Null) test operator 99 
NONE summary line 128, 130 


job description for batch run 42 
job log 22 
joining tables in a prompted query 87 


L null value 90, 162, 166, 168 
number of rows to use for sample 39 
LAST column usage 119 NUMERIC data type 160, 162 


LE, <=, join condition 87 
left (F19) function key 78, 148, 175 
LEFT edit command 76 Oo 
libraries 

*CURLIB library 3 
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*LIBL library 3 
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default library for QM tables 41, 154, 156 
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line commands 

after (A) 77 
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OMIT column usage 119 
online information 22 
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Opt prompt 17 
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outfile 
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outfile 187 
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